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Introduction 


Military  and  civilian  aircraft  in  the  1960's  and  1970's  used  many  separate  gauges,  dials,  lights, 
switches,  buttons,  circuit  breakers,  control  wheels,  and  levels  in  tightly  packed  aircraft  cockpits. 
The  introduction  of  new  instruments  and  data  sources  forced  a  competition  for  limited  cockpit 
space.  This  competition  was  partly  alleviated  by  the  introduction  of  microcomputers  and  video 
displays  into  the  cockpit  environment.  Multifunction  displays  (MFDs),  capable  of  presenting  a 
variety  of  information  fi-om  different  sources,  replaced  many  electromechanical  devices,  thereby 
freeing  room  in  the  aircraft  cockpit.  Current  MFDs  are  often  similar  in  appearance  and  usage  to 
automated  teller  machines  in  that  crew  members  push  buttons  to  move  through  a  hierarchy  of 
display  pages  contaning  instructions,  information,  or  lists  of  user-activated  functions.  They 
increase  the  total  amount  of  available  information,  with  the  limitation  that  only  some  of  it  is 
visible  at  any  given  time.  An  additional  benefit  of  MFDs  is  to  provide  a  simpler  layout  of 
cockpit  instrumentation,  so  that  crew  members  spend  less  time  scanning  for  information  and 
more  time  piloting  the  aircraft.  The  reduction  in  pilot  workload  due  to  the  introduction  of  MFDs 
in  the  cocl^it  was  a  primary  factor  in  eliminating  the  need  for  flight  engineers  in  many  current 
generation  transport  aircraft. 

Figure  1  schematizes  MFDs  as  they  are  used  in  a  variety  of  modem  aircraft.  Information  is 
supplied  on  a  large  computer  monitor.  Push-buttons  surround  the  monitor  to  allow  the  crew  to 
interface  with  the  MFD  computer.  Figure  1 A  shows  real-time  status  information  from  the 
aircraft  engines  and  other  aircraft  systems  (SYS).  Figure  IB  shows  targeting  information.  The 
push-buttons  along  the  sides  of  the  MFD  are  associated  with  software-generated  display  labels, 
indicating  jumps  to  additional  display  pages  containing  related  information.  Pressing  a  soft-key 
causes  the  MFD  to  display  a  new  page  containing  the  information  or  fimctions  indicated  by  the 
key’s  label. 

MFDs  typically  contain  a  wide  range  of  single  and  multistep  functions.  The  type  of  objects 
and  information  displayed  on  the  MFD,  the  data  acquisition  channels  that  are  represented  by  the 
displayed  objects,  the  set  of  active  database  links,  as  well  as  the  functions  that  soft-keys  can 
activate  are  commonly  grouped  together  logically  on  one  or  more  interconnected  display  pages. 
Pilots  dynamically  select  a  display  based  on  the  information  and  functionality  desired  to 
accomplish  changing  flight  management  or  combat  tasks  such  as  situational  awareness, 
navigation,  communications,  systems  monitoring,  battlefield  and  threat  monitoring,  and 
targeting. 

Despite  the  significant  impact  of  MFDs  on  the  layout  of  instrumentation  in  aircraft  cockpits 
and  the  responsibilities  of  crew  members,  little  is  known  about  how  users  search  for  information 
in  such  systems.  Several  studies  have  investigated  the  physical  characteristics  of  the  displays 
and  the  push-button  interface  (e.g..  Rash  and  Becher,  1982;  Hannen  and  Cloud,  1995;  Klymenko 
et  al.,  1997).  These  studies  help  insure  that  crew  members  can  see  the  monitor  and  reach  the 
buttons  for  a  variety  of  conditions  (e.g.,  direct  sunlight  using  protective  gloves).  Other  studies 
explore  the  opportunity  to  create  new  types  of  information  displays  (e  g.,  Braithwaite  et  al., 
1997).  In  contrast,  there  has  been  little  research  to  insure  that  crew  persons  can  quickly  search 
through  the  hierarchy  of  information  in  the  MFD  database  to  retrieve  needed  information. 
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A  B 


Figure  1.  Schematized  drawings  of  two  pages  fix>m  an  MFD  display  and  its  push4>utton  inter&ce. 

In  A,  the  systems  page  shows  information  on  engines  and  includes  legends  along  the 
right  to  indicate  that  pressing  Ae  associated  button  will  cause  the  display  to  present  the 
requested  informadoa  In  B,  the  same  display  screen  shows  a  page  with  targeting 
information. 

The  military  guidelines  (MIL-STD-1472D)  for  development  of  the  hierarchical  structure  of 
information  in  the  MFD  provide  few  instructions  and  little  justification.  The  small  number  of 
studies  investigating  hierarchy  design  issues  may  reflect  the  difficulty  of  the  problem.  As  described 
in  Francis  and  Reardon  {1997),  small  changes  in  part  of  a  hierarchy  can  have  ]vofound  effects  on 
search  times  elsev^diere  in  the  hierarchy.  Such  senativity  makes  general  guidelines  difficuk  to 
apply.  As  a  result,  hierarchy  creation  currently  remains  an  artistic  endeavor,  depending  primarily  on 
the  e}q)erience  and  intuition  of  the  designer. 

The  flsw  studies  e}q)loritig  the  impact  of  hierarchy  design  suggest  that  it  is  important  In  non- 
military  domains,  hierarchy  design  has  been  iden^ed  as  a  key  factor  in  overall  performance  and 
satisfliction  with  an  MFD  type  device  (Sq)pala  and  Salvendy,  1985;  Cook  and  Woods,  1996). 
Studies  using  simulated  military  aircraft  suggest  that  MFD  hierarchy  design  may  affect  crew 
workload  and  situation  awareness  (e.g.,  Reising  and  Curry,  1987;  Sirevaag  et  al.,  1993). 

To  promote  a  more  rigorous  aiudysis  of  hierarchy  design,  Francis  and  Reardon  (1997) 
developed  a  mathematical  framework  that  considers  a  variety  of  foctors  in  hierarchy  design.  The 
current  document  shows  how  to  apply  that  fiamework  to  particular  cases  of  hierarchy  design. 
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General  approach 


MFDs  trade  a  search  of  physical  space  for  a  search  of  virtual  space  through  the  hierarchy  of 
information.  Other  things  equal,  it  is  desirable  to  arrange  the  hierarchy  of  information  in  a  way 
that  minimizes  the  search  time.  Francis  and  Reardon  (1997)  provided  a  theoretical  framework  to 
consider  this  issue.  They  identified  an  optimization  method  that  chooses  the  best  layout  of 
information  in  the  hierarchy.  For  the  optimization  method  to  succeed,  it  required  a  model  of  the 
time  needed  to  search  through  the  virtual  space  of  the  MFD  hierarchy.  In  this  section,  we  briefly 
sununarize  the  model  proposed  by  Francis  and  Reardon  and  show  how  to  apply  it  to  a  particular 
design  task. 

Each  page  in  an  MFD  hierarchy  defines  a  unique  path  of  button  pushes  that  terminates  when 
the  page  is  shown.  Measuring  the  time  to  reach  a  hierarchy  page  requires  knowing  the  time 
needed  to  move  to  and  push  the  various  buttons  along  the  path  to  the  page.  These  movement  and 
push  times  all  contribute  to  a  motor  term.  These  times  are  possibly  distinct  from  the  time 
required  to  decide  which  button  to  push.  Such  decisions  require  reading  various  choices  until  the 
option  leading  to  the  target  page  is  identified.  The  times  to  read,  interpret,  and  decide  to  select 
contribute  to  a  categorization  term.  Together  with  any  computer  response  time,  this  analysis 
suggests  that  the  time  to  reach  a  page  in  the  hierarchy  will  be: 

T  =  (motor)  +  (categorization)  +  (computer  response). 

Each  of  these  terms  is  likely  to  vary  with  the  pattern  of  button  pushes  that  define  the  path,  the 
options  to  be  categorized  along  the  path,  and  the  information  displayed  by  the  computer.  By 
considering  the  variations  in  these  variables  for  different  buttons  and  items,  the  optimization 
method  selects  a  layout  that  maximizes  performance  according  to  any  designer-imposed 
constraint.  This  approach  uses  information  in  the  details,  or  microstructure,  of  the  human- 
computer  interface  to  maximize  performance. 

The  analysis  in  Francis  and  Reardon  (1997)  was  theoretical;  it  described  equations  and 
techniques  for  identifying  an  optimal  layout  of  information  when  specific  data  were  available. 

We  now  explore  methods  for  gathering  the  needed  data  and  demonstrate  the  utility  of  the 
method.  For  that  purpose,  we  developed  a  suite  of  computer  programs  to  investigate  hierarchical 
searches.  The  programs  will  be  described  briefly  in  the  ensuing  text  and  more  fully  in  the 
appendices.  The  next  section  describes  the  basic  interface  used  to  explore  hierarchical  search. 
Data  were  gathered  from  this  interface. using  methods  described  in  subsequent  sections.  The  data 
were  then  used  to  build  an  optimal  layout  of  pages  that  considers  the  microstructure  properties  of 
the  human-computer  interaction.  The  validity  of  the  optimization  method  was  then  verified  with 
further  experimentation. 

A  hierarchical  interface 


To  investigate  the  microstructure  of  hierarchical  information  retrieval,  we  wrote  a  program  in 
the  Java  programming  language  that  allowed  users  to  select  virtual  buttons  with  mouse  controls. 
Selecting  a  button  moved  the  user  through  a  virtual  hierarchy  of  information  and  generated  a 
new  set  of  options  associated  with  each  button.  Figure  2  shows  snapshots  of  the  interaction 
window  at  various  positions  along  a  path  to  a  target  item.  In  this  case,  the  display  portrays 
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Figure  2.  Three  displays  from  the  program  designed  to  investigate  user  interactions  in 

hierarchicd  search.  The  user  is  given  a  target  item  in  the  center  of  the  window  and 
moves  through  the  hierarchy  to  find  the  Hem.  The  user  moves  through  the  hierarchy 
with  successive  mouse  clicks  on  the  qjpropriate  buttons  to  reach  the  target.  A  shows 
the  top  level,  \^iere  buttons  code  major  systems  in  a  helicopter.  B  shows  a  screoi 
from  the  second  level,  where  buttons  code  various  aircraft  systems.  C  shows  a  screen 
from  the  bottom  level,  where  buttons  code  various  types  of  rotor  information, 
including  Tail_RPM,  the  target  Hem. 


4 


aircraft  information  suitable  for  use  in  a  military  helicopter.  After  pressing  the  Next  target 
button,  a  target  item  (sometimes  paired  with  its  parent  to  help  the  user  find  it)  was  displayed  in 
the  center  fi'ame.  The  user  was  to  move  through  the  hierarchy  toward  the  target  item  as  quickly 
as  possible. 

Figure  2a  shows  the  top  level  of  the  hierarchy,  where  the  options  are  various  aircraft 
information  and  the  target  is  Tail-RPM,  Rotor.  Selecting  the  Aircraft-SYS  button  changes  the 
labels  on  the  buttons  to  those  shown  in  Figure  2b,  where  the  options  are  various  choices  in 
aircraft  systems.  Selecting  the  Rotor  button  changes  the  labels  to  those  in  Figure  2c,  which  show 
options  for  the  rotor  system.  Selecting  the  Tail-RPM  hntton  means  that  the  user  has  found  the 
desired  item.  This  basic  scheme  was  used  in  a  number  of  different  ways  to  explore  hierarchical 
search. 


Measuring  motor  time 


Defining  the  motor  term  of  the  model  requires  identifying  the  time  needed  to  make  button 
presses  and  to  move  the  mouse  control  between  buttons.  This  cannot  be  done  during  a  normal 
hierarchical  search  because  the  time  to  find  an  item  includes  both  the  time  to  physically  push  the 
correct  buttons  and  the  time  to  categorize  items.  We  hypothesized  that  the  motor  time  could  be 
isolated  in  a  situation  where  the  user  knew  in  advance  where  to  move  the  mouse  control.  In  such 
a  situation  there  would  be  no  categorization  time. 

Thus,  we  created  a  program  that  required  the  user  to  select  pairs  of  buttons.  Figure  3  shows  a 
snapshot  of  the  program  window.  Each  button  is  numbered  between  0  and  7.  The  center  region 
specified  the  pair  of  buttons  that  were  to  be  pressed  in  succession.  The  program  measured  the 
time  between  the  first  and  second  button  presses.  This  measure  was  repeated  for  every 
combination  of  successive  button  presses,  including  repeated  selection  of  the  same  button.  (The 
only  exception  was  that  the  user  was  never  asked  to  make  a  movement  that  ended  in  the  Next 
target  button,  as  such  movements  never  occurred  during  searches  of  the  hierarchy.)  The  time  for 
each  movement  was  measured  several  times,  and  the  average  stored  in  a  file  for  later  use. 
Because  the  user  could  plan  the  movement  before  the  first  button  press,  we  hypothesized  that  the 
movement  time  was  a  pure  measure  of  how  long  it  took  to  physically  move  and  initiate  the 
mouse  control. 


Measuring  categorization  time 


The  optimization  technique  described  in  Francis  and  Reardon  (1997)  required,  in  addition  to 
the  motor  times,  the  time  needed  to  categorize  items.  Unlike  the  technique  for  measuring  motor 
times,  there  seems  to  be  no  direct  method  of  measuring  categorization  times.  Any  measure  of 
response  time  necessarily  will  include  both  categorization  and  motor  times.  We  need  to 
disentangle  these  terms  so  that  the  model  can  predict  response  times  when  the  hierarchical  layout 
is  restructured  and  the  items  are  paired  with  new  motor  times. 

To  disentangle  response  times,  we  modified  the  basic  hierarchy  search  program  so  that  it 
measured  the  time  between  successive  button  presses  as  the  user  went  through  a  path  toward  a 
target  item.  The  time  between  button  presses  was  coded  by  item  name  and  stored  in  a  file  for 
later  use.  We  refer  to  these  measures  as  between  item  search  times. 
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Figure  3.  The  piDgram  window  for  measuring  motor  time.  The  center  panel  displays  a 

sequence  of  button  presses  for  the  user  to  perform.  The  program  measures  the  time 
between  the  first  and  second  button  press.  Since  the  user  can  find  the  buttons  to  be 
pressed  before  starting  the  nmvement,  the  time  should  include  only  motor  time. 
Motor  time  was  measured  in  this  way  for  every  pair  of  buttons. 


Next,  we  used  the  previously  measured  motor  times  between  button  presses  and  the  between 
hern  search  times  to  derive  cat^orization  times.  We  used  the  following  logic.  The  between 
hern  search  time  includes  both  motor  and  categorization  time.  Thus,  subtracting  the  motor  time 
fi'om  the  between  item  search  time  should  leave  an  estimate  of  the  categorization  time.  This 
calculation  was  performed  for  every  hem  in  the  hioarchy. 

This  iq>proach  has  the  benefit  of  avoiding  another  difficult  problem  in  measuring 
cat^orization  times.  Previous  attempts  to  model  hierarchical  search  have  noted  that 
performance  crhically  depends  on  the  search  strategy  utilized  by  the  user  (Lee  and  MacGr^or, 
1985;  Parq)  and  Roske-Hofstrand,  1986;  Vandierendonck,  Van  Hoe  and  De  Soete  1988).  In  an 
extreme  case,  if  the  user  is  very  familiar  with  searching  through  the  hierarchy  and  knows  the 
button  presses  needed  to  reach  each  hem,  categorization  time  will  be  n^igible.  On  the  other 
hand,  if  the  user  has  no  experience  searching  through  the  hierarchy,  cat^orization  time  will  be 
substantial  and  highly  dependent  on  the  details  of  the  user's  strategy.  More  commonly,  a  user 
will  know  the  button  presses  needed  to  reach  some  hems  in  the  hierarchy  but  will  need  to  search 
labels  to  find  the  path  for  other  hems.  Such  effects  are  likely  to  be  highly  dependent  on  the  items 
in  the  hierarchy  and  their  significance  to  a  particular  user,  so  there  is  probably  no  way  to  model 
the  effects  of  learning. 

Our  measure  of  cat^orization  time  avoids  modeling  learning  effects  by  measuring  the 
resulting  behavior  that  depends  on  those  effects.  From  the  point  of  view  of  predicting  search 
times,  h  does  not  matter  w/ry  some  hems  are  cat^orized  more  quickly  than  others,  v/hat  does 
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matter  is  how  long  it  takes  to  categorize  each  item.  Our  measure  calculates  the  needed 
information  directly  without  worrying  about  the  underlying  details. 

With  the  motor  and  categorization  data,  it  is  possible  to  predict  the  time  required  by  the  user 
to  find  an  item  for  any  layout  of  information  in  the  hierarchy.  To  make  this  prediction  for  a 
single  item,  the  computer  simply  notes  the  path  needed  to  reach  the  target  item,  the  buttons  that 
must  be  pushed  along  that  path,  and  the  items  that  must  be  categorized  along  the  path.  The  time 
for  all  button  pushes  and  movements  and  the  time  for  all  categorizations  sum  to  equal  the 
predicted  search  time. 

Optimizing  hierarchical  layout 


With  the  ability  to  predict  search  times  for  any  layout  of  information  in  the  hierarchy,  it  is 
possible  to  search  through  different  layouts  for  the  one  that  minimizes  expected  search  time. 
Unfortunately,  there  are  so  many  different  possible  distributions  of  items  in  the  hierarchical 
structure  that  it  is  not  feasible  to  consider  them  all.  Instead,  we  used  a  computational  technique 
called  simulated  annealing,  as  described  in  Francis  and  Reardon  (1997).  This  computational 
algorithm  sifts  through  the  possible  hierarchical  layouts  to  consider  only  those  that  have  the  best 
chance  of  generating  small  search  times.  While  the  algorithm  does  not  guarantee  to  find  the 
optimal  layout  of  items  in  the  hierarchy,  in  practice  it  usually  produces  a  layout  with  a  search 
time  close  to  the  optimal. 

Testing 


A  final  program  takes  the  hierarchical  layout  generated  by  the  optimization  program  and 
generates  the  button  interface  for  user  interaction.  As  the  user  searches  for  specified  target 
items,  the  computer  keeps  track  of  the  search  times.  After  the  user  is  finished  searching  for 
items,  the  program  writes  to  a  file  the  predicted  mean  search  time  (as  generated  by  the 
optimization  program)  and  the  mean  actual  search  time  (as  measured  during  the  user's 
interaction).  These  are  then  compared  to  each  other  to  consider  the  accuracy  of  the  model's 
predictions.  They  are  also  compared  to  the  original  time  required  to  search  for  items  in  a  non- 
optimal  hierarchical  layout  of  items.  The  next  two  sections  describe  pilot  studies  that  used  this 
general  approach  to  hierarchy  design. 


Example  1 


The  first  example  shows  application  of  the  method  using  data  gathered  fi'om  a  single  user  (the 
first  author).  The  hierarchy  portrayed  geographical  information  (continent,  country,  city)  instead 
of  the  aircraft  information  portrayed  in  Figure  2.  This  change  was  incorporated  to  insure  that 
subjects  not  ftimiliar  with  aircraft  systems  could  participate.  The  methodology  of  building  an 
optimal  hierarchical  layout  remains  the  same  regardless  of  the  information  in  the  hierarchy. 
Subjects  were  asked  to  move  through  the  hierarchy  to  click  on  the  button  for  a  city,  country,  or 
continent. 
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The  programs  described  above  were  run  on  a  laptop  computer.  Of  note,  the  mouse  control 
was  utilized  through  a  touclq>ad  device,  which  is  common  on  a  variety  of  laptop  computers.  A 
touchpad  is  a.  small  touch-sensitive  pad.  A  light  touch  on  the  pad  gives  the  user  control  of  the 
cursor  placement.  Dragging  a  finger  along  the  surfiu^e  of  the  touchpad  moves  the  mouse  cursor 
in  the  same  direction.  A  mouse  click  is  initiated  by  quickly  tapping  twice  on  the  touchpad  in  the 
desired  location.  The  touchpad  device  is  useful  for  l^op  computers  because  it  offers  the 
functionality  of  a  mouse  with  small  space  requirements.  However,  precise  control  of  cursor 
movement  is  somewhat  difficuk  with  the  touchpad,  and  correction  adjustments  are  frequently 
necessary.  It  is  also  sometimes  difficult  to  start  and  stop  movement  of  the  mouse  cursor, 
especially  for  small  movements.  As  a  result,  sometimes  a  larger  movement  can  be  accomplished 
more  quickly  than  a  short  movement.  None  of  these  characteristics  affected  the  basic  q>proach 
to  hierarchy  design,  and  motor  movement  times  were  gathered  as  described  above.  For  eadi 
movement,  the  average  of  10  replications  was  used  as  the  measure  of  motor  time. 

If  all  items  in  the  hierarchy  are  accessed  equally  often,  and  the  user  is  very  familiar  with  the 
path  for  each  item,  there  is  no  difference  between  hierarchical  layouts.  Such  situations  are 
probably  very  rare.  For  most  MFD  applications,  some  items  are  searched  for  more  often  than 
others.  The  goal  of  the  derign  process  is  to  place  frequently  searched  items  at  the  end  of 
hierarchical  paths  that  are  quicldy  accessed.  To  emulate  the  inhomogeneity  of  search  frequency, 
we  created  artificial  mission  scenarios.  Each  scenario  required  the  user  to  seardi  for  a  fixed  set 
of  20  randomly  selected  herns  from  the  full  (268  item)  set.  In  each  scenario  10  of  the  items  were 
search^  for  5  times  and  the  other  10  were  searched  for  once.  For  each  scenario,  we  gathered 
categorization  data  and  built  and  tested  an  optimal  hierarchy. 

To  gather  categorization  data,  the  hierarchical  layout  was  partially  randomized  so  that  every 
item  was  located  underneath  its  appropriate  header  category,  but  was  in  a  random  (fixed) 
position  under  that  header  (e.g.  each  city  remained  under  hs  iqppropriate  country,  but  was 
randomly  assigned  to  a  button).  The  randomization  was  used  to  insure  that  there  were  no  order 
cues  (e.g.  alphabetical  order)  that  would  guide  the  user's  search  process.  A  scenario  was  run 
twice.  On  the  second  run  of  the  scenario,  between-item  time  was  measured  for  each  item 
oicountered  in  the  hierarchy.  These  hems  included  both  the  target  hems  in  the  mission  scenario 
and  the  items  located  along  the  paths  to  reach  the  target  hems.  We  did  not  use  data  from  the  first 
run  of  the  scenario,  as  h  would  likely  show  strong  learning  effects  for  those  hems  frequently 
searched.  The  average  between-item  time  for  every  hem  in  the  hierarchy  was  stored  in  a  file  to 
be  used  by  the  optimization  program. 

A  program  that  created  an  optimal  hierarchy  converted  the  motor  time  data  and  the  between- 
hem  data  into  independent  motor  time  data  and  cat^orization  time  data.  For  the  mission 
scenario,  the  program  then  considered  different  hierarchical  layouts  to  identify  the  one  that 
minimized  predicted  search  time.  This  was  a  time-consuming  process,  requiring  approximately 
45  minutes  for  a  scenario.  When  the  optimization  procedure  finished,  it  wrote  to  a  file  the 
hierarchical  position  of  each  hem. 

Finally,  a  testing  program  read  in  the  hierarchical  data  generated  by  the  optimization  program, 
and  the  user  participated  in  two  runs  of  the  sceiiario.  The  testing  program  g^ered  data  on  the 
second  run  of  the  scenario  to  measure  the  mean  time  to  reach  an  item  in  the  optimal  hierarchy. 
Figure  4a  shows  the  expected  time  required  to  find  a  single  hem  in  the  hierarchy  for  three 
different  mission  scenarios.  For  each  scenario,  three  values  are  plotted;  the  expected  search 
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Figure  4.  Mean  search  times.  A  shows  expected  search  times  for  three  scenarios  and  the 
average.  Three  measures  are  plotted  for  each  scenario.  Random  indicates  that  the 
layout  of  information  was  randomly  ordered  on  its  appropriate  page.  Optimal 
(predicted)  is  the  model’s  prediction  of  expected  search  time,  using  the  layout  of 
information  that  minimizes  predicted  search  time.  Optimal  (actual)  is  the  search 
time  for  the  optimal  layout  as  measured  through  user  interaction.  B  shows  averages 
across  three  trials  for  alphabetical,  random,  and  optimal  layouts. 
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time  for  the  r^om  hierarchy  (used  to  gather  between-item  data),  the  model-predicted  expected 
search  time  for  the  optimal  hierarchy,  and  the  actual  (from  user  testing)  expected  search  time  for 
the  optimal  hierarchy.  Averages  across  the  three  scenarios  are  also  plotted. 

For  the  random  hierarchies  it  took  approximately  4  seconds  to  find  an  item  in  the  hierarchy. 
When  the  Herns  were  rearranged  accor^ng  to  the  optimization  procedure,  it  took  approximately 
3  seconds  to  find  an  Hem.  This  corresponds  to  a  25%  reduction  in  search  time,  a  substantial 
savings  when  one  considers  the  large  number  of  searches  in  an  MFD. 

Also  noteworthy  is  the  close  corre^ndence  between  the  predicted  and  actual  performance 
on  the  optimal  hierarchy.  (By  Hs  design,  the  modd  must  agree  perfectly  with  user  performance 
on  the  random  hierarchies.)  The  strong  agreement  between  the  predicted  and  actual  performance 
suggests  that  the  model  of  search  times  accurately  captures  many  of  the  important  characteristics 
of  hierarchical  search. 

Finally,  we  wanted  to  compare  the  performance  on  the  random  and  optimal  hierarchies  to 
what  we  suspect  would  be  the  defiiult  ordering  in  many  situations.  We  measured  mean  search 
times  for  situations  where  the  hierarchy  items  were  ordered  alphabetically  on  the  buttons.  Figure 
4b  shows  the  averages  of  three  scenarios  for  the  alphabetical,  random,  and  optimal  hierarchies. 
The  alphabetical  search  times  are  similar  to  the  random  search  times,  and  both  are  substantially 
larger  than  the  optimal  search  time. 

It  is  instructive  to  note  some  characteristics  of  the  optimal  layout.  With  the  touchpad  mouse 
controll«‘,  it  takes  substantial  time  to  initiate  a  movement.  As  a  result,  the  optimal  layout  created 
paths  for  the  most  frequently  used  items  that  involved  repeated  pressing  of  the  same  button. 
Figure  5  demonstrates  the  path  for  a  commonly  accessed  item.  Those  items  that  could  not  be 
placed  along  a  repeating  path  had  paths  that  minimized  movement  time.  In  general,  this 
organization  is  consistent  with  the  guidelines  suggested  by  military  standards  (MIL-STD- 
1472D).  However,  the  computational  method  considers  more.  Certain  buttons  were  more  easily 
accessed  than  other  buttons  and  certain  paths  in  the  hierarchy  were  more  often  traversed  than 
other  paths.  It  is  no  trivial  task  to  decide  which  set  of  paths  should  be  associated  with  which 
buttons  because  changing  the  location  of  one  item  requHes  additional  changes  among  the 
children  of  that  item.  At  the  same  time,  one  cannot  identify  the  best  location  of  items  at  the  top 
levels  without  considering  the  best  locations  of  items  of  their  children.  This  type  of  cHcular 
dependence  makes  the  layout  choices  very  complicated.  The  computational  iq)proach  is  able  to 
weigh  all  these  dependencies  simultaneously  to  generate  the  best  overall  hierarchical  structure. 

The  overall  feel  of  searching  for  information  was  that  the  target  item  would  likely  be  found 
who-e  the  user  expected  H  to  be  and  would  be  easily  fux:essible.  We  suspect  that  m  addition  to 
reducing  search  times,  such  optimal  hierarchies  will  produce  fewer  errors  and  increase  overall 
user  satisfaction.  We  have  not  yet  investigated  these  issues. 
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Figure  5.  Hierarchy  displays  along  the  path  to  Monterrey,  Mexico,  for  the  optimized  hierarchy. 
The  user  needs  to  make  only  one  movement  (from  Next  target  to  N  America)  and  then 
simply  pushes  the  same  button  repeatedly  to  move  through  the  hierarchy.  Items  that 
cannot  be  placed  in  such  paths  (because  of  interference  from  other  item  paths)  are 
placed  on  paths  that  minimize  movement  time. 


11 


A  second  study  was  run  to  insure  that  the  methodology  was  general  to  a  number  of  different 
conditions.  For  this  purpose,  three  additional  users  participated.  None  had  extensive  practice 
woiidng  with  the  geognq)hical  hierarchy  interface.  The  programs  were  run  on  a  PC  computer 
with  a  standard  hand-held  mouse. 

For  subject  1,  motor  time  estimates  were  based  on  the  average  of  five  replications  for  each 
movement.  The  mission  scenario  was  created  in  the  same  way  as  in  Example  1 .  For  subjects  2 
and  3,  motor  time  estimates  were  based  on  the  average  of  three  replications  for  each  movement. 
The  mission  scenario  consisted  of  seven  different  hems,  with  individual  hems  assigned  a  unique 
number  of  replications  ranging  fi-om  1-7.  For  these  users  there  were  28  target  searches. 

Figure  6  plots  the  mean  search  times  for  the  users.  The  mean  search  times  are  generally 
smaller  than  for  Example  1,  probably  indicating  the  more  efficient  control  of  the  hand-held 
mouse  versus  the  touch-pad  device.  The  effects  of  optimization  are  not  as  strong  as  in  Example 
1.  This  could  be  because  the  users  were  less  practic^  searching  through  the  hierarchy  and  made 
more  mistakes  (two  participants  indicated  that  they  sontetimes  forgot  which  continent  was 
associated  with  a  country).  Consistent  with  this  interpretation,  user  3  seems  to  show  strong 
practice  effects.  If  such  a  resuh  were  verified,  it  would  emphasize  the  importance  of  gathering 
data  fi'om  experienced  users  (\i^ch  are  more  likely  to  mimic  crew  persons  in  military  aircraft). 
There  may  also  be  floor  effects  where  the  advantage  of  repeated  button  pushes  is  not  as  great  for 
the  hand-held  mouse  as  for  the  touch-pad  device.  Despite  these  possible  confounds,  the  optimal 
hierarchies  did  result  in  overall  shorter  search  times  than  the  random  hierarchies.  For  subject  1, 
additional  explorations  of  search  times  with  alphabetized  hierarchies  found  mean  search  times 
slightly  above  4  seconds. 


Cbhglwsigng 


We  have  developed  a  methodology  to  apply  the  theoretical  firework  of  Francis  and  Reardon 
(1997)  to  the  design  of  hierarchy  layouts,  lire  key  insight  in  this  methodology  is  to  fiurtor 
between-hem  times  into  motor  and  categorization  times.  By  measuring  motor  times  separately 
and  subtracting  them  fi’om  between-item  times,  the  method  avoids  rrumy  complicated  issues  that 
would  otherwise  prevent  accurate  prediction  of  search  times. 

We  developed  computer  software  to  explore  hierarchy  search  and  gather  data  for  designing 
optimal  hierarchies.  Two  pilot  studies  demonstrate  the  utility  of  the  methodology.  The 
hierarchies  that  minimized  predicted  search  time  were  found  to  be  substantially  better  than 
random  or  alphabetically  organized  hioarchies.  The  results  verified  the  benefit  of  optimizing 
hierarchy  layout  and  also  verified  the  adequacy  of  the  model  at  predicting  search  times. 
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Figure  6.  Mean  search  times  for  users  in  the  second  pilot  study.  The  optimized  hierarchies 
resulted  in  shorter  search  times  than  the  random  hierarchies. 
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To  apply  the  methodology  to  the  design  of  real  MFDs  requires  gathering  motor  time  in  a  real 
(or  accurately  simulated)  cockpit,  accurate  measures  of  between-item  search  times,  and  good 
measures  of  the  frequencies  with  which  crew  members  use  the  various  MFD  fimctions.  With 
this  data,  it  should  be  possible  to  optimize  the  layout  of  items  on  buttons  and  reduce  search 
times.  However,  one  should  consider  a  number  of  other  issues  before  applying  the  optimization 
approach  to  MFDs  in  cockpits.  First,  there  may  be  some  functions  that  must  be  reached  within 
specific  time  constraints  or  they  are  of  no  use  to  the  crew  (e.g.,  taking  evasive  action  under  fire). 
The  optimization  method  should  take  such  constraints  into  account.  Second,  the  motor  time  data 
may  vary  depending  on  the  function  being  searched  for.  For  example,  a  pilot  going  through 
checklist  procedures  before  take-off  may  need  to  spend  very  little  time  on  flight  controls  and  can 
quickly  move  through  button  pushes  of  the  MFD.  In  contrast,  a  pilot  taking  evasive  actions 
under  fire  may  need  to  keep  his  hands  on  flight  controls  as  much  as  possible,  thereby  increasing 
the  average  time  needed  to  push  buttons  on  the  MFD.  The  model  of  search  times  needs  to 
consider  that  some  items  may  be  associated  with  conditions  that  necessarily  slow  search  time. 
With  such  considerations,  the  optimization  method  can  design  the  hierarchy  layout  to 
accommodate  those  restrictions.  Third,  real  MFDs  often  place  restrictions  on  which  buttons  can 
be  used.  For  example,  in  Figure  1  A,  the  entire  left  side  of  the  display  is  covered  by  engine 
information  and  is  unavailable  for  labels  linking  to  other  pages.  Such  restrictions  have  not  been 
considered  in  the  hierarchy  search  programs  considered  here.  Fortunately,  there  is  nothing  in  the 
basic  methodology  to  prevent  consideration  of  these  issues.  Their  resolution  may  require 
additional  programming  and  data  collection,  but  the  theoretical  framework  remains  unchanged. 

A  related  issue  concerns  user  variability.  Even  in  the  pilot  studies,  there  are  notable 
differences  between  participants’  search  times  (there  were  differences  in  the  mission  scenarios  as 
well).  An  MFD  in  an  aircraft  must  accommodate  a  variety  of  users.  As  such,  proper  design  of 
the  hierarchy  must  gather  data  from  a  variety  of  users  and  create  a  distribution  of  motor  and 
categorization  times.  With  such  data,  it  should  be  possible  to  design  the  hierarchy  so  that  it 
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optimizes  performance  over  the  distribution  of  users.  Nothing  in  the  methodology  prevents  such 
design,  although  it  will  require  that  substantial  amounts  of  data  be  gathered  from  a  variety  of 
users. 

The  current  work  provides  the  first,  to  our  knowledge,  scientific  method  to  optimize 
hierarchical  layout  th^  considers  the  details  of  the  human-computer  interactions.  Our  analysis 
and  experimental  results  suggest  that  the  method  may  have  a  significant  impact  on  usability  of 
MFDs.  Given  the  growing  use  of  MFDs  in  both  military  and  civilian  aircraft,  it  is  important  to 
insure  that  they  are  designed  to  allow  efficient  retrieval  of  information.  Our  methodology 
provides  a  means  to  that  end. 
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Appendix  A.  Kerarchv  search  computer  software 


The  appendices  describe  the  computer  software  used  to  investigate  hierarchical  search.  All 
software  was  written  in  the  Java  programming  language  (for  a  discussion  of  Java,  see  Flanagan, 
1996;  Morrison,  1997).  This  language  was  chosen  because  it  has  built-in  commands  for  creating 
windows,  buttons,  and  handling  user  interfaces.  Java  programs  also  have  the  advantage  of  being 
machine-independent,  meaning  that  the  programs  will  run  on  any  machine  platform  (PC, 
Macintosh,  Unix),  provided  that  platform  supports  a  Java  virtual  machine. 

Java  is  an  object  oriented  programming  language,  meaning  the  programmer  defines  classes 
that  contain  attributes  and  methods  for  manipulating  the  attributes.  One  benefit  of  this 
progranuning  approach  is  that  a  class  can  inherit  characteristics  of  another  class,  thereby 
reducing  the  need  to  rewrite  code.  Figure  A-1  shows  the  relationships  between  the  classes  used 
to  investigate  hierarchical  search. 


Figure  A-1 .  The  Java  classes  written  to  explore  hierarchy  searches.  HierarchyPage 

provides  data  structures  and  methods  useful  for  working  with  an  item  in  the 
hierarchy.  It  is  used  by  many  of  the  other  programs.  DisplayHierarchy  is  a 
class  for  basic  windowing  and  interfaces  with  a  given  hierarchy  and  mission 
scenario.  The  classes /*rac//ce,  SearchTime,  TestHierarchy,  and  MotorTime  all 
derive  from  this  class  and  add  or  change  methods  to  compute  different 
statistics  and  read/write  to  different  files.  Setup  provides  a  general  scheme  for 
creating  a  hierarchy  structure.  Optimize  modifies  the  general  scheme  to  create 
an  optimal  hierarchy.  BuildOptimalHierarchy  provides  an  interface  to  go 
through  each  step  in  the  process  of  building  a  hierarchy  optimized  for  a  single 
mission  scenario. 
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Appendix  B.  Summary  of  Java  classes 


This  section  provides  object  specifications  for  each  Java  class  used.  For  each  class,  the  object 
specification  provides  a  brief  description  of  the  class'  purpose,  the  attributes  associated  with  the 
class,  and  the  methods  used  by  the  class  to  carry  out  calculations. 


Description 


The  HierarcfayPage  class  rq)reseiits  an  item  in  the  hierarchy.  It  keeps  trade  of  the  item  name,  the 
path  ofbutton  pushes  needed  to  reach  the  item,  the  sin^e-number  position  t^  cotre^nds  to  the  path,  the 
fiequency  with  whidi  the  page  is  searched  for,  and  the  levd  at  which  the  button  path  terminates. 


Attributes 


Oautype 

DcscriptiMi 

name 

String 

The  name  of  the  page. 

categorize_time 

int 

A  statistic  of  how  long  it  takes  to  reach  the  page.  Its  precise  definition 
depends  on  the  class  that  invokes  the  HierarchyPage. 

path 

into 

An  array  that  describes  the  sequence  ofbutton  pushes  needed  to  readi 
the  page. 

num_replica 

int 

The  number  of  times  the  page  is  to  be  searched  for  in  the  mission 
scenario. 

replies 

int 

The  number  of  times  the  page  has  been  seardied  for. 

num_biittons 

int 

The  number  of  buttons  in  the  hierarchy. 

num_levcU 

int 

The  number  levels  in  the  hierardiy. 

Methods/Events 


MeOottKjoue 

KetnmType 

Paraaetens 

DcacripiMB 

getPosHion 

int 

Returns  the  position  of  the  page. 

getLevd 

int 

Returns  the  level  of  the  page. 

setPathfromPosition 

void 

int  position 

Derives  the  path  of  the  page  fiom  a  given 
position. 

letPath 

void 

into  path 

Sets  the  path  of  the  page  given  an  array. 
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Description 

The  Di^layHierarchy  class  reads  in  hierarchical  information  from  a  data  file  and  creates  a 
window  with  buttons  to  display  the  hierarchy.  It  handles  all  button  presses  and  relabels  the  buttons  to 
emulate  movement  through  the  hierarchy.  It  also  provides  routines  for  gathering  statistics  on  user 
performance. 

Attributes 


Attribute  Name 

Data  Type 

DesciiptioB 

randGen 

Random 

A  random  number  generator. 

iium_buttons 

int 

The  number  of  buttons  in  the  hierarchy. 

num_levels 

int 

The  number  of  levels  in  the  hierarchy. 

b 

An  array  of  buttons.  Hierarchy  labels  are  placed  on  these  buttons. 

target 

The  name  of  the  item  the  user  is  to  find. 

search_for_counter 

Label 

A  label  that  displays  information  in  the  ttuddle  panel  of  the  window. 

iiext_target 

Button 

The  Next  target  button. 

level 

int 

Identifies  the  current  level  of  the  hierarchy  during  user  search. 

found_tai*get 

boolean 

Notes  whether  the  user  has  found  the  target  item. 

start_time 

long 

Used  for  gathering  reaction  time  data. 

num_trials 

int 

The  total  number  of  trials  in  a  rtussion  scenario. 

trial 

int 

The  current  number  of  trials  that  have  been  performed. 

bp_count 

int 

A  count  of  how  many  button  presses  have  been  made  during  the 
current  search. 

path 

into 

Keeps  track  of  the  ciurent  sequence  of  button  pushes  generated  by 
the  user. 

page 

HierarchyPageO 

The  pages  of  the  hierarchy. 

block 

int 

The  number  of  blocks  that  have  been  run 

num_blocks 

int 

The  number  of  blocks  that  are  to  be  run  during  a  testing  session. 

targ^_index 

int 

The  index  of  the  target  item. 
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Methods/Events 


HfcQKNt  Ifnnc 

iiiiHiiiii 

Vanasetm 

'Oesn^^bNi  « 

actkn 

boolean 

Event  e. 
Object  arg 

Handles  all  user-generated  events. 

update  statistics  uo 
t.targd 

void 

int  Q  path 

Not  implemented. 

update  statistics  tar 
grt 

void 

intOpaih 

Not  implemented. 

get_data_froni_file 

void 

Reads  in  hieiardiy  and  mission  scenario  data  fiom 
the  file  "data/items.txt*. 

write_to_file 

void 

Not  implemented. 

findPatewHliPatli 

int 

int  Q  path 

Identifies  the  index  of  the  hierarchy  page  that  has 
the  given  path  of  button  pushes. 

GctSearcUteai 

void 

Selects  the  next  item  for  dte  user  to  search  for. 

buildOisplayPafe 

void 

Relabels  all  buttons  to  emulate  movement  throu^ 
the  hierarchy. 

Description 

The  Practice  class  instantiates  the  DisplayHieiarchy  class. 


It  has  no  new  attributes  or  methods. 


Description 

The  SeaichTime  class  extends  the  Di^layHieraichy  class  by  providing  calculations  of  the 
between-item  tunes. 

Attributes 


Attribute  Ntnae 

Bafaf^iie 

SescriptiM 

rqilics 

into 

An  array  that  provides,  fiu'  each  item,  a  count  of  how  often  that  item  has 
been  encountered  while  the  user  searches  the  hierarchy. 

rirst_replica 

int 

A  count  of  how  many  times  the  user  has  eiKountered  any  item  for  the 
first  time. 

firtt_tinie 

int 

A  measure  of  how  the  between-item  times  for  the  first  time  an  item  is 
encountered. 

Methods/Events 


MefbodNsMe 

Return 

Panoaeters 

Descriptfan 

update  stafistki  uo 
t.tarsrt 

void 

int  Q  pad) 

Calculates  between-item  time  for  the  current  tiser 
selection. 

update_statistks_tar 

get 

void 

into  path 

Calculates  between-item  time  for  the  current  user 
selection. 

get_data_from_file 

void 

Differs  fin>m  method  in  super  only  in  the 
declaration  oi  some  variables. 

write_to_rik 

void 

Writes  average  between-item  times,  hierarchical 
l^out,  and  mission  scenario  to  file 
”data/seardi_time.txt". 
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Description 

The  MotoiTime  class  extends  the  DisplayHierarchy  class.  It  uses  the  methods  and  data  structures 
in  DisplayHierarchy  to  create  a  window  and  hierarchy  interface,  however,  it  redefines  other  methods  to 
explore  movement  times  between  pairs  of  buttons. 


Attributes 


Attribute  Name 

DaUType 

Description 

replies 

intQD 

An  array  that  provides,  for  each  pair  of  buttons,  a  count  of  how  often 
the  user  has  p^ormed  the  movement  between  the  pair. 

num_replics 

int 

The  number  of  times  the  user  must  make  a  movement  between  each 
pair  of  buttons. 

targetl 

String 

The  name  of  the  first  button  in  a  movement  pair. 

target! 

String 

The  name  of  the  second  button  in  a  movement  pair. 

buttonl 

int 

The  index  of  the  first  button  in  a  movement  pair. 

button! 

int 

The  index  of  the  second  button  in  a  movement  pair. 

found_targetl 

boolean 

Set  to  true  when  the  user  selects  the  first  button  in  the  movement  pair. 

time 

intDD 

An  array  that  provides,  for  each  pair  of  buttons,  the  sum  of  time 
required  to  move  between  the  pair. 

stat 

intDD 

An  array  that  provides,  for  each  pair  of  buttons,  the  sum  of  time  squared 
required  to  move  between  the  pair.  Used  to  calculate  standard 
deviations  of  motor  times. 

Methods/Events 


Method  Name 

Return  Type 

Parameters 

Description 

action 

boolean 

Event  e. 
Object  arg 

Handles  all  user-generated  events. 

GetSearehPattem 

void 

Randomly  selects  the  next  pair  of  buttons  for  the 
user  to  make  a  movement 

get_data_from_file 

void 

Sets  up  hierarchy,  does  not  actually  read  from  a 
file. 

write_to_fiIe 

void 

Writes,  for  every  pair  of  buttons,  the  average 
motor  time  and  the  standard  deviation  to  file 
"data/motor.txt". 

Description 

The  TestHieiarchy  class  extends  the  Diq>layHietaichy  class  by  providing  calculations  of  the  time 
needed  to  find  the  target  item. 


Attributes 


:  AttvOMite  Ntnhe"' 

DescripticM 

orisinal  est 

int 

The  total  time  required  to  search  the  mission  scenario  with  the  original 

hierarchical  layout  Read  in  fiom  a  data  file. 

est 

int 

The  predicted  time  required  to  seardi  the  mission  scenario  with  the 

optimal  layout  Read  in  from  a  data  file. 

Methods/Events 


MeftodlCnne 

Return  t>pe 

Fanonetors 

JDescr^rtion 

update  statistics  tar 
get 

void 

into  path 

Calculates  the  time  taken  by  the  user  to  find  the 
target  item. 

get_data_froni_file 

void 

Reads  in  the  optimal  hierarchical  k^out  and 
mission  scenario  information  from  the  file 
"data/optinul.txt”. 

write_to_file 

void 

Writes  mean  seardi  time  data  (original,  predicted, 
actual)  to  file  *data/mean_time.txt”. 
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Description 

The  Setup  class  reads  in  user  supplied  data  files,  which  define  a  hierarchy,  and  creates  a  mission 
scenario.  It  modifies  the  hierarchy  layout  so  it  is  partly  randomized,  and  writes  the  hierarchy  layout  and 
mission  scenario  information  to  a  file. 

Attributes 


AttriimteName 

Data  Type 

Description 

num_buttons 

int 

The  number  of  buttons  in  the  hierarchy. 

num_levels 

int 

The  number  of  levels  in  the  hierarchy. 

num_labels 

int 

The  number  of  pages  in  the  hierarchy. 

page 

HierarchyPage  □ 

The  pages  of  the  hierarchy. 

Methods/Events 


Method  Name 

Return  Type 

Parameters 

Description 

get_data_from_file 

void 

Reads  in  hierarchical  information,  starting  with 
the  file  ‘'ltem_names/level0.txt".  Then  reads  in 
other  files  with  names  matching  the  item  names. 

create_new_hierarchy 

void 

Randomizes  the  hierarchy  layout  and  defines  a 
mission  scenario. 

write_to_file 

void 

Writes  the  hierarchical  layout  and  mission 
scenario  information  to  the  file  ”data/items.txt”. 

findPagewithPath 

int 

into  path 

Identifies  the  index  of  the  hierarchy  page  that  has 
the  given  path  of  button  pushes. 

swap 

void 

int  level,  int 
item,  int 
new_item 

Swaps  the  paths  of  pages  item  and  new_item. 

Also  changes  the  paths  of  the  children  of  these 
items  to  keep  the  hierarchical  order  intact 

Description 

The  Optimize  dass  extends  the  Setiq)  class.  It  reads  from  files  between-item  time  data  and  motor 
time  data.  It  calculates  categorization  time  data  arxi  defines  a  model  search  times.  It  then  uses  an 
(ytimization  technique  to  find  a  hierarchical  hyout  that  minimi/es  predicted  search  time.  Theqrtimal 
hkiardiy  (along  wiA  its  misskm  scenario  and  predicted  search  time)  is  written  to  a  file. 


Attributes 


9iata 

Tlltpe 

Deseriptiwi^.  - ,  ^ 

motor_tinie 

intQQ 

The  time  needed  to  move  between  ead  pair  of  buttons. 

ast 

int 

The  time  needed  to  go  through  the  mission  scenario  with  the  original  layout 

original_est 

int 

The  time  needed  to  go  through  the  mission  scenario  with  the  original  layout 
Using  class  computations.  Useful  fi>r  comparing  to  ast  to  detect  bugs. 

cuiTent_est 

int 

The  predicted  search  time  for  the  current  hierarchical  layout 

local_ininima 

int 

The  predicted  search  time  for  the  best  hierarchical  layout  yet  found  by  the 
optimization  rxMitine. 

Methods/Events 


Method  Name 

lletwai 

Tm 

Fanuaeten 

SescriptkM 

tet_data_from_fik 

void 

Reads  in  hierarchical,  mission  scenario,  and  between- 
item  time  data  from  file  ”data/seardi_time.txt”.  Creates 
hierarchy  pages.  Also  reads  in  motor  time  data  from 
file  "daWmotor.txt”. 

cteate_ncw_liierar 

chy 

void 

Computes  categorization  time  and  stores  it  in  hierarchy 
pages.  Uses  an  optimization  procedure  to  find  the  hier> 
archical  layout  that  minimizes  predicted  search  time. 

local_minima_chcc 

k 

boolean 

Returns  true  if  the  current  hierarchy  layout  isalocal 
minima  of  predicted  search  time. 

computed_expecte 

d_seiunchjtime 

int 

Returns  the  predicted  time  (in  milliseconds)  for  the  usa 
to  search  through  the  mission  scenario  with  the  current 
hierarchy  layout 

write_to_file 

vmd 

Writes  the  hierardiical  l^out  and  mission  scenario 
information  to  the  file  "data/optimal.txt". 

swap 

void 

int  level,  int 
item,  int 
new_item 

Swaqrs  the  paths  of  pages  hern  and  newjtem.  Also 
chariges  the  paths  (k  the  children  of  these  items  to  keq) 
the  hierarchical  order  intact 
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Description 


The  BuildOptimalHieraichy  class  provides  an  interface  to  guide  a  user  through  the  creation  of 
gathering  all  needed  data  and  testing  an  optimal  hierarchy.  It  calls  each  class  as  needed. 

Attributes 


AttritwteName 

Data  Type 

Descriptitm 

b 

Button  iii 

An  array  of  buttons. 

Methods/Events 


MethodName 

R^uro 

iililiBi 

Parameters 

Descriptioa 

action 

boolean 

Event  e. 
Object  arg 

Handles  all  user-generated  events.  Calls  appropriate 
classes  according  to  buttoa 
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This  section  provides  the  source  code  of  each  Java  class. 


r  class  HisrarchyPags 

TNa  class  providas  an  object  to  contain  al  the  data  retavant  to  a  spadfic  paga 
in  a  hierarchy.  This  class  is  used  by  several  dUTarent  programs. 

Writton  by  Greg  Francis,  Purdue  University 
August  1997 


The  views  opinions,  and/or  findings  contained  in  this  report  are  those  of  the  author 
and  should  not  be  construed  as  an  official  Department  c(  the  Army  position,  or  decision, 
unless  so  designated  by  other  documentation. 

*/ 

class  HiararchyPage 

{ 

M  num_levats,  num^buttons; 

String  name; 

int  categorizejtirTM; 

int  replies,  num_replics; 

kit  pathQ  >  new~ nt  [num_lavels]; 

HierarchyPage(int  num.levels,  int  num.buttons.  String  name,  int  categoti2e_time, 
int  replies,  kit  num  replies) 

{ 

this.num_levels  ■  num.leveis; 
this.num_buttons  *  num_buttons; 
this.name  «  name;  ~ 
this.categorize_time  »  categorize_time; 
this.repln  ^  repkes; 
this.num  repkes* num  rapkes; 

} 


//  returns  the  position  that  conresponds  to  the  page's  path 
int  getPosition() 

{ 

kit  posilion*0; 

kit  tempj>oeilion*0,  sum*0; 
fbr(int  t*0;i<num  levels;i'*"«') 

{ 

lf(path(i]l--1) 

{ 

temp_posRion  *  temp_position*num_buttons  *  path{i]; 
sum  -r*  (int)Math.po^(double)num  buttons,(doubie^)); 

} 

) 

position  *  temp_position'*«um; 
return  position; 

} 

// returns  the  level  of  the  page 
int  getLavelO 
{ 

int  lavel*-1; 

fbr(int  i*0;i<num  levels;i't"«-) 

{ 

if(pathp]»-1) 
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{ 


level  =  i-l; 
i=nu(n  levels; 

} 

} 

return  level; 

} 

//  computes  the  page's  path  for  the  given  index 
//  this  method  must  be  explicitly  called 
void  setPathfromPosition(int  p^on) 

{ 

//set  default 

for(int  i=0;i<num_levels;i++) 
path[i]  =  -1; 

int  sizeD  =  new  int  [num_levels]; 
int  level=0,sum=^; 

//  compute  range  of  indices  for  each  level 
for(int  i=  0;i<num  levels;i») 

{ 

size[i]  =  (irTt)Math.pow((double)num_buttons,(double)i); 
sum  sizefi]; 
if(position  <  sum) 

{ 

level  =  i; 
i=num  levels; 

} 

} 

//  work  backwards  through  levels  to  find  path 
for(int  i=level;i>0;i-) 

{ 

//  find  position  in  level  i 

krt  temp_position  -  position  -  (sum-size(i]); 

path[Kl]  =  (intXtempj}osition%num_buttons); 

//  reset  index  as  parent  index 
sum-0; 

for(int  j=0;j<i-1;j++) 
sum+=size{j]; 

position  =  sum  (int)(temp_position/num  buttons); 

} 

} 

//  this  method  sets  the  path  by  copying  an  array 
void  setPathfintQ  temp) 

{ 

for(int  i=0;i<numjevels;i++) 
path[i]  =  temp(i]; 

} 
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import  Java.awt*; 
import  Java.util.Random; 
import  Java.util.Oatt; 
import  Java.io.*; 

r  ciaaa  DiaplayHiorarchy 

Thia  ciaaa  aata  up  a  display  scraen  wlh  txittona  artd  ttian  spacdias  targets  for 
ttMUSsrtofindinttMhiaratcNcy.  Data  on  ttis  hierarchy  is  road  in  from  the  Ms 
*data/Kema.txr.  No  output  Me  is  created. 

Written  by  Greg  Francis,  Purdue  University 
August  1907 


The  views  opinions,  and/or  finrinos  contained  in  this  report  sre  those  of  the  author 
and  should  not  be  construed  as  an  official  Department  of  the  Army  position,  or  decision, 
unless  so  designated  by  other  documentation. 

V 

public  class  DisplayHierarchy  extends  Frame 

{ 

RsTKiom  rartdGen  >  rtew  RsndomO; 

M  ruim.buttorw,  num_levels; 
int  num~labels; 

Button  bO; 

String  target; 

Label  search_for,counter; 

Button  next  target; 
int  level-0; 

boolean  found_targat-true; 

long  startjime; 

int  numjtrials-0,  trial  -0; 

M  bp_count-0; 

MOi^: 

HierarchyPage  pagefl; 

Mbloclr-O; 
int  num_bloclcs«1 ; 
int  target_lndex; 

pubHc  DispiayHierarchy(String  title) 

{ 

super(tlUe); 

//set  size  of  SearchTirrw  window 
this.resize(600,400); 

//Set  font 

Font  font «  new  Fontf  Helvetica’, Ford.PLAIN, 24); 
aatFont(font); 

//Create  menubar 

MenuBar  menubar-  new  MenuBarQ; 
thie.setMenuBar(menubar); 

//Create  Me  menu.  Add  Close. 

Menu  Me-new  Menuf  File*); 

Me.add(new  MenuKemf  dose*)); 
menubar.add(Me); 

Random  randGen  -  new  RandomO; 

get.data.  ,from_flleO; 

// defirte  range  of  path  variable  for  later  use 
path  -  new  M  [num_levels]; 


b=new  Button(num_buttons]; 
fbrCint  i=0:i<num_buttons;i++) 

bp]  =  new  ButtonC  *); 

//Establish  panels  for  buttons  and  info 
Panel  left  =  new  PanelQ; 

Panel  right  =  new  PanelQ; 

left.setLayout(new  GridLayout(num_buttons/2, 1,10,20)); 
fbr(int  fO;  i<num  buttons/2;K-i-) 
lett.add(b[i]);~ 

right.setLayout(new  GridLayout(num_tKJttons/2, 1 ,1 0,20)); 
fbr(int  Fnum_buttons/2;  i<num_buttons;i+->’) 
right.add(b[i]); 

this.setLayout(new  BorderLayout(5,5)); 

this.addrWesr,left); 

this.addrEasr,nght); 

//  Set  up  everything  else  on  bottom  panel 
Panel  bottom^  new  ParrelQ; 
bottom.setLayout(new  GridLayout(2,1 ,1 0,20)); 
search_fbr  =  new  Label  fPress  button  to  start  *); 

Panel  next  =  new  PanelQ; 

next.setLayout(new  FlowLayout(FlowLayout.CENTER)); 

nextjarget  =  new  ButtonfNexttargeT); 

next.add(next_target); 

counter  =  new  Label  p+(num_trials)); 

bottom.add(next); 

bottom.add(counter); 

this.add("Center',search_for); 

this.addfSouth*,bottom); 

this.packQ; 

this.showQ; 

public  static  void  main(String  argsQ) 

{ 

DisplayHierarchy  f  =  new  DisplayHierarchyf  Hierarchy^; 


r  This  method  handles  all  user  interactions  with  the  hierarr^y. 

It  changes  button  labels  according  to  movement  through  the  hierarchy. 
It  notes  when  the  target  has  been  found. 

It  calls  methods  for  measuring  various  response  times.  */ 
public  boolean  action  ( Event  e.  Object  arg) 

{ 

if(e.target  instanceof  Menultem) 

{ //Watch  for  quit  command 
String  label  =  (String)  arg; 
if(label.equalsf  Close*)) 
disposeQ; 

} 

if(e.target  instanceof  Button) 

{ 

String  s=  (String)arg; 

if  (e.target  ~  next  target  &&  found_target) 

{ 

if  ( trial  <  num_trials) 

{ 

GetSearch  ItemQ ;  //  Get  new  target 

found  target=folse; 

} 

else  //  see  if  another  block  is  needed 

{ 

block++; 
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K(blocknnum  blocte) 

{ 

•Mreh_fcr.MtT«(t(*AI  dorM...Thanlar); 
vwte  to  floO; 

) 

•IM  if(biock  <nuin  lilocls)//raMt«v«rylhingrorthoiMXtUock 

{ 

•Mich_for.s«tT«xtf  N«xt  btock...*); 
for(int  ^Knum 
{ 

paga(qjeplcs«0; 
pa^Q.categorize  ttrM»0; 

} 

Mal*0; 

found  targotstnio; 

} 

} 

} 


if(  ls.oquala(targ6t)) 

{ 

//If  not  target,  act  on  putaied  button  to  move  through  hierarchy 
for(iiil  i  >0;i<num  bultonB;i«"») 
lf(e.target ««  b{iD~ 

{ 

path(bp_count]  >  i; 

update_atatiattca_not_target(path); 

//  Retabel  buttona  to  emulate  moving  through  the  hierarchy 
bp_oount-«>; 

//  iTgo  throt^  bottom  of  hierarchy,  reeet  to  top  page 
if(bp  count»ruim  leveie-l) 

{ 

bp.countaO; 

f^nt  )BO'J<num_levelej>>) 
paithQ]s-1; 

} 

buiidOieplayPage(path,  bp_count,  b); 
return  true; 

} 

) 

//  If  target,  record  between-Kem  time  and  prepare  for  next  item 
elee  if(lfound  target)  //  ignore  repeated  preseinga  of  target  button 
{ 

foitint  i  >0;i<num_buttons;i>-») 
if(e.target «  b{iD 
{ 

fourKtJtaiget^true; 
path(bp  count]  *  I; 
updale_atatielica_target(palh); 
bp_courtt'»>; 

lf(bp  count»>THim  levete) 

{ 

bp.counM); 

for(int  j»OJ<num_leveleJ-M-) 
path(i]«-1: 

} 

} 

aearch  for.setTextf  Preas 'Next  targeT); 

} 

} 

return  true; 


//  This  method  updates  the  statiatics  needed  when  there  is  a  button  preas  that 
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//  does  not  result  in  the  target  being  found 
public  void  update  statistics_not_target(int{]  path) 

{ 

} 

//  This  method  updates  statistics  for  a  button  press  that 

//  results  in  the  target  being  found. 

public  void  update_statistic5  target(intQ  path) 

{ 

} 

II  This  method  reads  d^a  from  the  input  file 
public  void  get_data  from  fileQ 
{ 

try 

{ 

String  filename  =  *data/items.txr; 

File  f  =  new  File(filename); 

FileInputStream  labels  =  new  FUelnputStreamff); 

DataInputStream  label_file  =  new  DatalnputStream(labels); 

II  Get  num_levels  and  num_buttons 
String  s  =  labei_file.readUneO; 

//parse  out  needed  info 
II  get  rHim_levels 
int  ertd  =  s.indexOff ,“); 

String  temp  =  s.substring(0,end); 

numjevels  =  (int)  Float.vaiueOf(temp).float\/alueO; 

II  get  ruim_buttons 

temp  s  s.substring(end't'l); 

num_buttons  =  (int)  Float.vatueOf(temp).floatValue(); 

II  Compute  number  of  labels  in  Hierarchy  for  later  use 
for(int  i=0;i<numjevels;i++) 

numjabels  ■•’=  (int)Math.pow((double)num_buttons, (double)!); 

//  Create  pages 

page  =  new  HierarchyPage[numJabets]; 

//  get  page  info  from  data  file 
fbr(int  i=0:i<numjabels;i++) 

{ 

s  =  label.file.readUneO; 

//parse  needed  information 
//  get  name 

int  name_end  =  s.indexOf(","); 

String  name  =  s.substring(0,name_end); 

// get  position 

int  position_end  =  s.indexOff  *,nanie_end+1): 

String  s2  =  s.substring(name_end-»^1  ,position_end); 
int  position  =  (int)  Float. valueOf(s2).floatValueO; 

//  get  time  (always  equals  0) 

int  time_end  =  s.indexOff  ,",position_end+2); 

String  s3  =  s.sufastring(p^ion_end-*^2,time_end); 

M  time  =  (int)  Float.  vaiueOf(s3).floatValue0; 

//get  replications 

int  reps_erKl  =  s.iastIndexOff ,"); 

s2  =  s.substring(reps_end-t-1); 

int  reps  =  (int)  Fioat.valueOf(s2).float\/aiueO; 

num_trials  *=  reps;  //  keep  track  of  how  many  triais  there  will  be 

//  set  up  page  info 

page[i]  =  new  HierarchyPage(  numjevels,  num_buttons,  name,  time, 
0,  reps); 

page[i].setPathfromPosition(position); 
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} 

} 

calch(ExMpUon  •) 

{ 

Syatwn.outpriiillnrEiror  '♦•.toSMngO); 

) 

} 

//Thit  method  writes  data  to  the  output  Me 
pubic  void  write  to  MeQ 
{ 

} 

// This  method  idenWee  the  index  of  the  page  that  haa  the  apedfied  path 

//  of  button  DreoMO. 

pubic  int  findPagewthPath(intO  path) 

{ 

MMemB-l; 

fbr(int  MiKnum  labeis;l-M^) 

{ 

boolean  found_K>  true; 
int  checkfl  *  new  bit  (num_levels]; 
check  «  page[i].path; 
for(int  )BO;i<num  levelaJ«-») 

{ 

If(check0]  I- pathOD 

{ 

found  ifBfolae; 

} 

} 

if(found  I) 

{ 

Kern  >>i; 
fonum  labels; 

) 

} 

return  Kern; 


//This  method  gets  the  next  target  Kern  for  the  user  to  search  for.  ItconsidefB 
//  how  often  each  Item  is  to  be  searched. 

pubic  void  GetSearchItemO 

{ 

//  pick  an  Kern  at  random,  but  not  Kern  zero 

bit  Kern  <■  (bitX^^>fi'  *f>B('*'KiG*n.nextlntO)%(num_labeiS'1))'»1; 

//  make  oertabi  the  Kern  is  to  be  searched  for 
whie(page(Kem].repics  >«  pagerrtem].num_repics) 

ftem  *  (btKMath.abs(randGen.nextbitoy%(num_labeis-1)}^1; 

page(Rem].replics-M^; 

target  >  page{lem].name; 
targetjndex  ■  ftem; 

//  get  button-presses  and  level  for  selected  page 
bit  tempo  *  Int  (num_levels]; 
temp  >  page(ftem].|Mth; 
level  *  page{item].getLevetO; 

// If  dty,  identify  country  to  ease  search 

StrlrH|s«i-; 

lf(levei«2K 

// And  page  that  corresponds  to  parent 
bit  parent  jiathQ  >  new  bft  [num.levels]; 


34 


fbrOnt  i=0;i<numjevels;i++) 
parent_path[i]  =  temp{i]; 
parent_path[level]  =  -1 ; 

M  parent.index  =  findPagewithPath(parent_path): 
s  =  ”,  *-ti}age[parent_index].name; 


trial++: 

search_fbr.setText(target-*«); 

counter.setTextr''«'(num_trials-trial)); 

fbr(int  i=0;i<num  levels:i++) 
path{il=-1:~ 


bp_count=0: 

buildDisplayPage(path,bp_count,b); 

Date  now  =  new  DateQ; 

staft_time  =  now.getTimeO;  //  start  clock  for  first  pair  of  button  presses 


} 

//  This  method  builds  the  display  for  the  appropriate  level  and  path  taken 
//  by  the  user  as  he  moves  through  the  hierarchy 

void  buildDisplayPage(int  Q  path,  int  level,  ButtonQ  b) 

{ 

int  D  temp  =  new  int  (num_levels]; 

forCmt  i=0;i<num_levels;i++)  //  copy  path  to  dummy  array 
temp(i]  =  path[i]: 

H  find  label  for  each  button 
fbr(int  k=0;k<num  buttons:k++) 

{ 

temp[level]  -  k; 

b(k].setLabel(page[findPagewithPath(temp)].name); 

} 

} 

} 


35 


import  DisplayHiarwchy; 

/*  dan  PracUco 

This  dan  aals  up  a  diaplay  acraan  wlti  buttona  and  than  apadfln  targats  for 
thauaartofindinthahiarafchiqr-  Tha  hiararchical  information  ia  road  in  from 
tha  fla  *data/itamB.t](r.  It  don  not  produca  any  output  fln. 

Written  by  Grag  Franda,  Purdua  UnivaraKy 
Augu8t1997 


Tha  viawa  opiniona,  and/or  findinga  containad  in  thia  report  are  thon  of  the  author 
and  ahould  not  be  conatruad  n  an  oflidai  Department  of  tha  Army  poalion,  or  dedaion, 
union  80  daaignatad  by  other  documentation. 

*/ 

pubic  dan  Practica  axtanda  DiaplayHiararchy 

{ 

pubic  Practica(String  titia) 

{ 

aupar(tltla); 

} 

pubic  atatic  void  main(String  argaQ) 

{ 

Setup  atp  >  new  SatupO;  //  Create  mission  scenario 
Practice  f  >  new  PracticefPractice*); 

} 

) 
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import  java.awt.*; 
import  java.utiI.Random; 
import  java.util.Date; 
import  java.io.*; 
import  DispiayHierarchy; 

r  class  SearchTime 

This  class  sets  up  a  display  screen  with  buttons  and  then  specifies  targets  for 
the  user  to  find  in  the  hierarchicy.  The  time  between  each  pair  of  button  presses 
(between-item  time)  is  noted  and  coded  by  the  label  of  the  second  button. 
Average  between-item  times  are  stored  in  the  file  ‘data/searchJime.txT. 

WrMen  by  Greg  Francis,  Purdue  University 
August  1997 


The  views  opinions,  and/or  findings  contained  in  this  report  are  those  of  the  author 
and  should  not  be  construed  as  an  official  Department  of  the  Army  position,  or  decision, 
unless  so  designated  by  other  documentation. 

*/ 

public  class  SearchTime  extends  DispiayHierarchy 

{ 

int  D  replies; 
int  first_replics; 
int  first_time; 

public  SearchTime(String  title) 

{ 

super(title); 

} 

public  static  void  main(String  argsQ) 

{ 

Setup  stp  =  new  SetupQ;  //  create  mission  scenario 
SearchTime  f  =  new  SearchTimef  Get  between  item  time’); 

) 

//  This  method  updates  the  statistics  needed  when  there  is  a  button  press  that 

//  does  not  result  in  the  target  being  found 

//  Overrides  the  method  in  super 

public  void  update_statistics_not  targetCintQ  path) 

{ 

//  verify  that  we  are  on  the  right  path.  Do  not  gather  data  for  mistakes 
boolean  error  =  false; 
fbr(int  i=0;i<=bp  count;i++) 

{ 

if(path[i]  !=  page[targetjndex].path[i]) 
eiTor=true; 

} 

if(!error) 

{ 

int  index  =  findPagewithPath(path); 
if(index  1=  -1)  //  catch  bug 

{ 

Date  now  =  new  DateQ; 

//  calculate  between-item  time 

page{index].categorize_time  ■•'=  (int)((long)now.getTimeO  -  (long)  start_time): 
start_time  =  (long)now.getTimeO; 

if(block  ==  num_blocks-1)  //  keep  track  of  encounters  on  last  block 
replics[index]-i"i-; 

System.out.println(page[index].name-i’”>page[index].categorize_time+”-i-replics{index]); 


//  update  estimates  for  first  time  encouirters  with  an  item 


lf(block->0  U  rap«c«(in(te4— 1) 

{ 

firat_tinM  **  pag«{indtx].categortzc_tinw: 
flrat 

1 

} 

} 

) 

// This  method  updatM  statMics  for  a  button  pran  that 
//  rwuto  in  ttw  taigat  being  found. 

//  Ovenidee  method  in  euper 

pub«c  void  update  atatMics  target(inlQ  path) 

{ 

Date  now  •:  new  DateO; 

int  index  ■  lindPagewithPath(path); 

if(index  l>-1) 

{ 

page(index].calegorize_time  **  (intX(long)naw.getTlmeO  -  (long)  atart_time); 
atait.time  « (long)now.getTimeO; 

if(block»  num_biocto-1)  // keep  track  of  encounteis  on  laat  block 
rap8cspndex]-M'; 

Syatem.outprinttn(page(index].naine«*  ’‘•pagefindex].categorize_t>mr»’  ’^-repicsOndex]); 
II  update  ectimates  for  fkat  encountera  wkh  an  Hern 
if(block«>>0  &&  repfica(index]»1) 

( 

fM_time  **  page(index].categortze_lime; 
flrat  rapiice4>; 

} 

} 

} 

//  Thie  method  reade  data  from  the  input  ffle 
//  Overridee  method  in  super 
public  void  get  data  from  fileO 
{ 

num_blocks  ^  2;  H  overrides  default  in  super 

{ 

String  Hename  «  *data/Kems.txr; 

Fie  f  B  new  Fiie(filename); 

FleInputStream  labels  >  new  FlelnputStream(f); 

DatainputStream  label_fle  *  new  DatalnputStream(labeis); 

//  Get  num_levels  and  num_buttons 
String  s  «>  iabel_fle.readUneO; 

//parse  out  needed  info 
//  get  num_levele 
bit  end  *  s.indexOf(*,*); 

String  temp  >  s.subetri^O,end); 

num_levelB  >  (bit)  Float.vslueOf(lemp).float\/alueO; 

//  get  num_buttons 

temp  >  s.wbstring(end>1); 

num_buttons  » (bit)  Float.valueOf(temp).floatValueO; 

//  Compute  number  of  labels  bi  Hierarchy  for  later  use 
for(int  iBO;i<num_leveis;H-*') 

num_labels  **  (bfl)Math.pow((double)rxim_buttons,(double)i); 

//Create  pages 

page  *  new  HieraichyPage{num_lsbetsl; 

repics  B  new  int(num_labels];  //  a  counter  for  how  often  each  page  is  encountered 

//  get  page  info  from  data  fie 
fbr(int  iBO;i<num  labels;i'M') 

{ 

s  B  label_flie.readLJneO; 
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//parse  needed  infbnnation 
//get  name 

M  name.end  =  s.indexOff 

String  name  =  s.substring(0,name_end); 

// get  position 

int  position_end  =  s.indexOff  ,",name_end+1); 

String  s2  ='s.substring(name_end-r'1  ,position_end); 
int  position  =  (int)  Float. valueOf(s2).float\/alueO; 

//  get  time  (aiways  equals  0) 

int  time_end  =  s.indexOff  ,",position_end+2); 

String  s3  =  s.substring(position_end+2,time_end); 
int  time  =  (int)  Fioat.vaiueOf(s3)!floatValueO; 

//get  repiications 

int  reps_end  =  s.lastIndexOff  f); 

s2  =  s.substring(reps_end+1); 

int  reps  =  (int)  Float. valueOf(s2).floatValueO; 

num_trials  reps;  //  keep  track  of  how  many  trials  there  will  be 

//  set  up  page  info 

page{i]  -  new  HierarchyPage(  numjevels,  num_buttons,  name,  time, 
0,  reps); 

page[q.setPathfromPosition(position); 

} 

} 

catch(Exception  e) 

{ 

System.out.prinUnf  Error  ‘‘-•'e.toStringO); 

} 


//  This  method  writes  data  to  the  output  file 
//  Overrides  method  in  super 
public  void  write  to  fileQ 
{ 

//  Open  output  file 
try 
{ 

FMeOutputStream  out_file; 

out_file  =  new  FileOutputStreamfdata/search_time.txr); 

PrintStream  out2  =  new  PrintStream(out_file); 

//  Write  info  to  data  file 

StringBuffer  sb1  =  new  StringBuffer(numJevels+",  "+num_butlons); 
out2.println(sb1  .toStringQ); 
int  current_est=0; 

System.o«jtprintln(first_time+'  "+fitsl_replics): 
for^int  i=0;i<num_labels;i++) 

{ 

current_est  +=  page[i].categorize_time: 
if(replics[i]==0) 

{ 

replicsp]  =  first_replics; 
page[i].categorize  time  =  first_time; 

} 

StringBuffer  sb  =  new  StringBufrer(page[i].name'r’’,  ’+page[i].getPositionO-'- 
’+(int)((double)page[i].categori2e_time/(double)replicas(i])+", "+ 
pag^i].num_replics); 
out2.println(sb.toString0); 

} 

StringBuffer  sb3  =  new  StringBuffer(Total  search  t»t»e  =  "♦current_est): 
out2.println(sb3.toString0); 

} 

catch(Exception  e) 

{ 

System.out.printlnf  Error  “+e.toStringO); 

} 

} 

} 
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iinpottJava.awt*; 
import  java.u(il.Random; 
iropoit  Java.utU.Data; 
hnfMtt  Java.io.*; 

Import  DisplayHiararchy; 


r  daaa  MotorThna 

This  daaa  aats  up  a  display  scraan  with  buttons  and  than  spacdias  movamants  for 
thausar.  Tha  tima  to  compMa  aach  movamant  is  notad.  The  rasuttirtg  data  is  storad 
in  tha  flia  'data/motor.txT. 

Writtan  by  Grag  Francis,  Purdua  Univarsity 
August  1997 


Tha  viaws  opiniona,  and/or  findings  containad  in  this  raport  are  Ihoaa  of  tha  author 
and  should  not  ba  conatruad  as  an  official  Oapartmant  of  tha  Army  position,  or  decision, 
uniass  so  designated  by  other  documarttation. 

*/ 

pubfic  ciaaa  MotorTIma  extends  DisplayHiararchy 

{ 

Siring  targatl ,  target2«*Naxt  targaT; 

M  bultoni  ,button2; 
booiaan  found_targat1>>lrua; 
ini  rapHcsQO; 

NtimaOQ; 

MatatOQ; 
int  num.replics; 

public  MotorTime(String  tiOa) 

{ 

supar(titla): 

} 

public  static  void  main(String  argsQ)  { 

Frame  f  ■  new  MotorTimafMotor  bma  data*): 

} 


//  This  method  handies  all  user  interactions  with  the  button  presses. 

//  It  notes  tha  thna  to  make  tha  first  button  press,  tha  second  button  press,  and 
//  it  stores  the  cUfferenca  in  an  array  for  statistics, 
public  boolean  action  ( Event  a.  Object  arg) 

{ 


Strings*"*: 

lf(a.targat  inslancaof  Button) 
s  >  (String)  arg; 

if(  s.aquals(targot1)  &&  Ifbund.targatl) 

{  //If  first  target  is  salaclad 
Date  now  *  new  DataQ: 
atait_tima  >  (long)rww.gatTimaO;  //  note  thna 
foundltargetl  *true; 
return  true; 

} 


if(  s.aquais(targat2)  &&  foundjargatl ) 

{ //  If  found  second  target  after  findbig  first 
Data  now  »  new  DataQ; 
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//  Update  statistics 
if(trial>0) 

{  //but  not  for  first  press  of 'Next  Targer  button 

//  Save  search  time  in  array  for  later  statistical  computation 
time[button1Kbutton2]  '•'=  (int)((long)now.getTime{)  -  (long)  start_time); 
stat(button1][button2]  +=  Ont)Math.pow((double)((long)now.getTimeO  ■ 
(long)  start  time), 2);  //to  calculate  variance 

} 

//When  all  done  write  statistics  to  file 
if(trial  ==  num_trials) 
write_to_ffieO: 

if  (trial  <  num_trials) 

GetSearchPatterrrO;  //  Get  new  movement  pattern 

else 

search_for.setTextCAII  done...Thanks!”); 
fbundjtargetl  =false; 


} 

if(e.target  instanceof  Menuttem)(  /A/Vatch  for  close  command 
String  label  =  (String)  arg; 
ifOabel.equalsfClose‘'))disposeO; 

} 

return  false; 


//  This  methods  sets  up  everything.  K  takes  its  name  from  the  super,  vrhere  information 
//  is  read  in  from  a  fUe.  There  is  no  file-input  here, 
public  void  get_data  from  fileO 
{ 


num.buttons  *8; 
numjevels=1; 

//  Compute  number  of  labels  in  heirarchy  for  later  use 
forfmt  i=0:t<=numjevels;i+'*-) 

num_labels  *=  (int)Math.pow((double)num_buttons,(double)i); 

//  create  variables  for  statistical  calculations 
replies  =  new  int  [num_buttons+11(num_buttons+1]; 
time  =  new  int  [num_buttons+1J(num_butlons+1]; 
stat  =  new  int  (num_buttons+1]lnum_buttorrs+11; 
num_replics=3; 
trial=  0; 

num_trials=num_replics*(num_buttons+1)*(num_buttons); 

//  Do  not  need  movements  ending  in  "Next  Targer,  so  fill  replic  counter  for 

//  those  movements 

fbr(int  k=0;k<num_buttons+1  ;k++) 

replic^][num_buttorts]  =  num_replics; 


//  This  method  writes  statistics  on  motor  time  to  a  file 
public  void  write  to  fileQ 
{ 

//  open  output  file 
try 
{ 

FileOutputStream  out_file; 

out_file  =  new  FileOutputStream('data/motor.txr); 

PrintStream  out2  =  new  PrintStream(out_file); 

fbr(irTt  i=0;i<num_buttons-i-1  li-r-r)  //  go  through  ewry  pair  of  button  pushes 
for(int  j=0:j<num  buttons+1j++) 

{ 

double  average  =  0.0; 
double  st_dev  =  0.0; 
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// Calculate  avarig* 

avaraga  >  (doubla)tiina(iljy(doubla)  num_rapllca; 

// Calculate  atemtard  daviatlon 
lf(num_rapaca>1) 

atjctev  *  Math  .aqrt(((doul3te)atet(m]  - 
~  ((loubla)nuin_rapllca*Math.pow(avaraga,2)y(cloubla)(num_raplica-1)); 

//Write  to  fite  tha  paga  Indax,  avaraj^,  atendard  daviatlon 
StringBuflar  sb5  ■  naw  StringBu(rar(H'*  ■♦averaga*'  * 

♦at_dav): 

//  Opan  output  file 


out2.println(8b5.toStringO); 

} 

} 

catoh(Excaption  ax) 

{ 

Syatam-ouLprinUnfError  *-»ax.toStringO); 

} 


// Thia  malhod  ktentifiaa  a  pair  of  button  puthaa  for  tha  uaar  to  maka 
II  it  takaa  into  account  how  many  timaa  aach  pair  muat  ba  parformad 
public  void  GetSaarchPattam  0 
{ 

//  Get  new  peir 

buttoni  >  (int)(Math.aba(randGan.naxtlntO)%(num_buttona'*^1)); 
button2  ■  (int)(Math.abc(randGan.naxtlntO)%(num_buttona+1)); 

whila<rapica{button1Ibutton2}>«num  rapica) 

{ 

buttoni  ■(lnt)(Math.aba(randGon.noxtlntO)%(num_buttona'»1)); 
button2  « (int)(Math.abo(randGan.naxtlntO)%(num_bultona«1)); 

} 

roplca(bulton11button2}4"«’;  //  Updata  rapication  count  for  aalactad  pair 
triaK-r;  //  Updata  trial  countar 

// spectfy  tiWQets 

If(bulton1  »  num  buttona)  //  button  8  ia  *Naxt  tergcT 
targatl  « 'Neid  targaT; 
alaa 

taigatl  * ’•♦buttoni; 


if(button2  »  num  buttona) 
targat2B’Na)dtargar; 

alaa 

taigat2>’’-»button2; 

//  put  labala  on  buttona 
foitint  j>0'J<num  buttonaj-t-r) 
bO].aalLabair«i): 

8aarch_for.aatTaxt(targal1  ♦’  ->  ’♦targat2); 
oountaraatText(~'+(num  triala4rial)); 

) 

} 
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import  java.util.Date; 
import  Java.k).*; 
import  DisplayHierarchy; 

/*  class  TestHierarchy 

This  class  reads  in  hierarchy  data  from  ‘data/optimal.txT  and  creates  a  display  with  buttons 
to  allow  the  user  to  serach  for  items  in  the  mission  scenario.  Itie  total  search  time 
is  computed  and  the  mean  search  time  is  written  to  the  file  ‘‘data/mean_time.txr. 

Written  by  Greg  Francis,  Purdue  University 
August  1997 


The  views  opinions,  and/or  findings  contained  in  this  report  are  those  of  the  author 
and  should  not  be  construed  as  an  official  Department  of  the  Army  position,  or  decision, 
unless  so  designated  by  other  documentation. 


public  class  TestHierarchy  extends  DisplayHierarchy 

{ 

int  original_est; 
intest; 

public  TestHierarchy(String  title) 

{ 

super(title); 

) 

public  static  void  main(String  argsQ) 

{ 

TestHierarchy  f  =  new  TestHierarchyfGet  between  item  time*); 

} 

//  This  method  updates  the  statistics  needed  when  there  is  a  button  press  that 

//  does  not  result  in  the  target  being  found 

//  Overrides  the  method  in  super 

public  void  update_statistics_not  target(intQ  path) 

{ 

} 

//  This  method  updates  statistics  for  a  button  press  that 
//  results  in  the  target  being  found. 

//  Overrides  method  in  super 

public  void  update  statistics  target(int(]  path) 

{ 

Date  now  =  new  DateQ; 

int  index  =  findPagewithPath(path); 

if(index  !=-1) 

pagejindex] .categorize  time  ■•'=  (int)((long)now.getTimeO  -  (10*^9)  stait_time); 

} 

//  TNs  method  reads  data  from  the  input  file 
//  Overrides  method  in  super 
public  void  get  data  from  fiieO 
{ 

num_bloci(s  =  2;  //  overrides  default  in  super 

try  “ 

{ 

String  filename  =  ’data/optimal.txT; 

File  f  =  new  File(filename); 

FHelnputStream  labels  =  new  FilelnputStream(0; 
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OatalnputStTMin  lab«i_fle  >  cmw  OatalnputStrMm<label»); 

//  Oct  num_ltv*ls  and  num_buttont 
String  a  >  labal_Maj«adiJnaO; 

Z/parae  out  info 
//  gat  num_lovala 
M  and  >  a.lndaxOf(*,*); 

String  tamp  >  a.aubafring(0,and); 

num_lovala  ■■  (M)  Float.  valueOf(lamp).floatValuaO: 

//  get  num.buttona 

temp  B  a.aubatring(endf1); 

num.buttona  *  Ont)  Float.  valueOf(lemp).floatVaiueO: 

//  Compute  number  of  labela  in  Hierarchy  for  Mer  uae 
(br(int  i>0;i<num_leveia;i'M') 

num_labota  **  (i'<t)Math.powr((double)num_bultona,(double)0; 

// Create  pagoa 

page  «  new  HiorarchyPage(num_labol8]; 
path  *  new  M  (num.ievata]; 

//  get  page  info  from  data  file 
fbr(int  Miknilm  iabela;H-») 

{ 

a  ■  iabal_file.raadUneO; 

Z/paiae  rieeded  information 
//gat  name 

M  name.end  *  a.IndexOff,*); 

String  name  >  a.8ubetring(0,name_end); 

//getpoaRion 

M  poaiUon.end  >  a.indexOff  *,name_en(k1); 

String  a2  sVaubetringfname.and^l  ,poation_end); 

M  poaition  « (int)  Float  valueOr(82).floatValueO; 

//girt  time 

int  time.end  >  8.indexOf(*  *4>oalion_en(k2): 

String  a3  <■  a.8ubatring(paeRion_en(k2,time_ond); 
mt  tiriM  •  (int)  Float  valueOf(a3).floatValueO; 

//pet  rapteatim 

int  repa_end  >  a.laatlndexOfr,*): 

a2  >  a.aubatring(ropa_end'»1 ); 

int  rapa  >  (int)  Float  \^ueOf(82).floatVaiueO; 

num_trial8  repa;  //keep  track  of  how  many  trials 

//  aet  up  page  info 

page(i]  ^  new  HierarchyPage(  num_leveis,  num_buttons,  name,  time, 
0,  repo); 

page(i].a^athfromPostion(poeition); 

} 

//  Get  original  aearch  tinw  for  random  hierarchy 

a  >  label_fle.readUneO; 

end  *  s.MlndexOff  *); 

tamp  >  a.8Ubatrfrrg(en<H'1); 

original.oet  >  (int)  Float  vaiueOf(temp).ftoatValueO: 

//  Get  prodictod  search  tirtw  for  optimal  hierarchy 

a -label  Ne.raadUneO; 

end-s.lastlndexOfr*); 

temp  -  s.subatring(end'«-1); 

eat  -  (int)  Float valueOf(tmp).floatVaiueO; 

} 

catch(Exc8ption  e) 

{ 

System.outprindnfError  *'«e.toStringO); 

} 

} 

// This  method  writes  data  to  the  output  fie 
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//  Overrides  method  in  super 
public  void  write  to  fileO 
{ 

//  Open  output  fiie 
try 
{ 

FiieOutputStream  out_file; 

out_fiie  -  new  FiieOutputStreamf  data/meanjtime.txr); 

PrintStream  out2  =  new  PrintStream(out_file); 

//  Write  info  to  data  file 

//  add  up  actual  search  times,  gathered  with  this  program 

int  actual_est=0; 

fbr(int  i=0;i<num_labels:i++) 

actual_est  +=  page[i].categorize_time; 

StringBuffer  sb3  =  new  StringBufferf  in  seconds/item  -  Original  search  time  =  "* 
((double)(original_est/num_triais)/1  OOO)-*- 
SnExpected  search  time  =  ‘■•■((double)(est/num_trials)/1000)'«- 
InActual  search  time  =  '■•■((double)(actual_est/num_trialsyiOOO)); 
out2.println(sb3.toStringO); 

} 

catch(Exception  e) 

{ 

System.out.printinf  Error  "■•■e.toStringO); 

} 


} 


import  Java.util.Random; 
import  Java.util.Oite; 
import  Java.io.*; 

rciaaa  Setup 

This  ciaea  raade  in  ueer-auppied  data  flae  that  define  a  hietarchical  itructure. 
It  re-orders  the  hierarchical  structure,  defirtee  a  mteaion  acerwrio,  artd  vwitee 
al  the  Information  to  the  Me  'dstaAems.txr. 

Written  by  Greg  Francie,  Purdue  University 
August  1997 


The  views  opinions,  and/or  findings  contained  in  this  report  are  thoee  of  the  author 
and  should  not  be  construed  as  an  official  Department  of  the  Army  position,  or  decision, 
unless  so  designated  by  other  documentation. 

•/ 

public  class  Setup 

{ 

M  num.buttone,  num_leveiB; 

M  num_labals; 

HiararchyPage  pagefl; 

public  SatupO 

{ 

get_data_from_fileO: 
create  new  hierarchyO; 

> 

public  static  void  mainfString  argsQ) 

{ 

Setup  f  *  new  SetupO; 

} 

/*  This  method  reads  in  data  from  specified  Mes.  Names  of  Kerns  in  the  first  level  are 
In  a  Me  called  *ltem_names/level0.txr.  The  names  of  items  in  the  subsequent  levels  are 
in  files  with  Meruimes  *ltem_names/<item_name>.txr,  where  <Kem_name>  is  given 
In  the  level0.txt  Me.  */ 
public  void  get  data  from.MeO 
{ 

//  Get  info  from  category  data  Mes 
try 
{ 

String  Mename  *  ‘Item  names/levei0.txr; 

File  f- new  Rle(Menarne); 

FleInputStream  labeis  *  new  FielnputStream(f); 

DataInputStream  labei_Me  >  new  OatalnputStream(labeis); 

//  Gat  num_levels  and  num_buttons 
String  s  >  tabel_Me.readlJrieO; 

//parse  out  info 

//  get  num_levals 
int  end  *  s.indexOff,’); 

String  temp  >  s.subiBtring(0,end); 

num_levels  s  (int)  Float.vaiueOf(lemp).floatValueO: 

//  get  num_bultons 

temp  *  s.substring(end4'1); 

num_buttone  <■  (int)  Float.  valueOf(temp).floatValueO; 
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//  Compute  number  of  labels  in  Hierarchy  for  later  use 
forfint  i=0:i<numjevels:i++) 

num_labels  (int)Math.pow((double)num_biAtons,(double)i); 

//  Create  pages 

page  =  new  HierarchyPage[num_labels]; 

fbrCint  l=0;i<num  labels:i++) 

{ 

page{i]  =  new  HierarchyPage(  num_levels,  num_buttons,  **,  0, 0,  0); 
page{i].setPathfromPosition(0) ; 

} 

//  Load  in  item  names  and  position  in  Hierarchy,  first  levei  only 
System.out.prinUnfLoading  names  from  file.*); 
forfint  j=1  :j<num  buttons+1;j++) 

{ 

s  =  label_file.readLineO; 

//set  paths 

int  D  path  =  new  int[numjevels]; 
path  =  page[j].path; 
pathlO]  =  H: 


pageQJ.name  =  s.trimO; 

} 

} 

catch(Exception  e) 

{ 

System.out.printlnf  Error  "+e.toStringO): 

} 

//  Now  load  in  other  items  using  name  from  parent  as  filename 

forfint  item=1  ;item<numjabeis;item-i’-*')  //cyde  through  all  pages,  except  top,  which  is  nothing 

{ 


int  levels  page['item].getLevelO: 

ifflevel  <  num  levels-2  &&  level  l=  -1 )  //set  children  of  parent 

{ 

//  get  path  for  parent  page 
into  temp  =  new  int[numjevels]; 
temp  =  page{item].path; 

String  s  =  page{item].name; 

if(s.length0>1)  //  do  not  look  for  file  if  filename  is  blank 

{ 

try 

{ 

FileInputStream  labels  =  new  FileInputStreamf  ltem_namesr+s+*.txr): 
OataInputStream  label_file  =  new  DatalnputStream(labels); 
fbrfirrt  j=0;j<num  buttor»sj++) 

{ 


String  s1=label_file.readLineO+'”; 

if(s1  .lengthO>0  &S  Isl  .equaisfnuir)) 
si  =  si  .trimO; 

else 

si  =”: 

//build  path  for  child  page 
mtQ  tempi  =  new  intfnumjevels]; 
forfint  k=0;k<num_levels:k++) 
tempi  [kj  =temp[k]; 
tempipevel+1]  =  j; 

//  find  next  unused  page  and  put  item  there 
forfint  m=1;m<numjabels:m+*) 

{ 

int  0  int2  =  new  intfnumjevete]; 
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Int2  «  pag«(m].palh; 


bootaan  found>4nM; 
for(int  n>0;n<num  lavattirH-*’) 
{ 


i»(W2ln]l--1) 

{ 

found  >  Mm; 
n>num  tcvalo; 

) 

} 

ir(found) 

{ 


pag«(m].satPath(t«fnp1 ); 
paoe(mi.nanrM  >  *1; 
m>num  tabato; 

) 

} 

} 

} 

calch(Excaption  a) 

{ 

Systam.outprinttnC’Error  ''^.toStringO); 

} 

} 

alM  //  If  NananrM  it  blank,  buHd  blank  pagaa  undamaath 

{ 

far<int  j>OJ<nufn  buttonaJ-M') 

{ 

Strirxjal  »**: 

//buM  path  for  chid  paga 
MO  tampi  >  naw  int(num_lavals]; 
for(int  k*0;k<num_laval8;k4’'») 
tampi  [k]  >  tamp[k]; 
tainp1(lwal-»1]>j; 

//  find  naxt  unuaad  paga  and  put  lam  thara 
fbr(intm«1;m<num  tabal8;m'»«) 

{ 

M  0  Int2  *  new  int(num_lavals]; 

Int2  B  paga(m].path; 

boolaan  foundstrue; 
lbr(int  n»0;n<num  lavela:n+*) 

{ 

lf(M2(n]  I-  -1) 

{ 

found  *  falM; 
n^num  levels; 

} 

) 

if(fbund) 

{ 

paga(m].satPath(tefnp1 ); 
paga(mj.nama  BSl; 
m^num  labels; 

} 

) 

} 

} 

} 

) 

} 

r  This  method  scrambles  the  order  of  the  hierarchy  so  I  is  paitislly  randomized. 
It  also  defines  the  mission  scenarlo.V 
pubic  void  craate_new_hierarchyO 
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Random  randGen  =  new  RandomO; 

//  Now  scramble  paths  to  make  a  random  hierarchy 
System.out.println('Randomizing  hierarchy”); 
fbr(int  item=1  ;item<num  tabelsiitem-r-r) 

{ 

//  get  buttorvpresses  and  ievei  for  selected  page 
int  tempo  =  new  int  [num_levels]; 

temp  =  page{item].path; 
int  ievei  =  page(item].getLevelO; 

//now  pick  a  new  button  from  the  same  branch  in  the  hierarchy 

int  new_btn  =  temp{level]; 
while(new_btn  ~  temp(level]) 

new_btn  -  (int)(Math.abs(rand6en.nextlntO)%num_buttons); 

//  identify  path  for  new  item 
int  new_temp[]  =  new  kit  [numjeveis]; 
for(int  i=0:i<numjevels;i++) 
new_temp{i]  =  tempp]; 
new_temp(level]  =  new_btn; 

//  now  find  the  item  with  this  path 

int  new_item  =  findPagewkhPath(new_temp); 

swap(le  vel  ,ttem  ,new_item); 


//  Fix  naming  problem  (bug-fix) 
fbrOnt  i=0;i<num_labeis;i-r"») 

{ 

ifCpagefil-name.equalsf  ”)) 
page{i].name=“"; 

} 

//  Now  set  up  replications 
System.out.printinf  Creating  mission  scenario'); 

//System .out println(’Setting  up  replication  data.'); 

//  7  items  with  corresponding  replira 
fbr(int  i=1;i<=7;i++) 

{ 

kit  item  =  (int)(Math.abs(randGen.nextlntO)%(num_labels-1))+1; 
while(pag^item].num_replics  !=0 1|  page[item].name.length0<1 ) 
item  =  (int)(Math.abs(randGen.nextlntO)%(numJabels-1))+1; 
page(item].num_replics  =  i; 

} 

//Write  data  to  file 
write_to_fileO; 


r  This  method  writes  the  created  hierarchy  to  the  file  'data/items.txT.  */ 
public  void  write  to  fUeQ 
{ 

//  Open  output  file 
try 
{ 

FUeOutputStream  out_file; 

out_file  =  new  FileOutputStream(’data/items.txt'); 

PrintStream  out2  =  new  PrintStream(out_file); 

//  write  new  Hierarchy  to  file 

StringBuffer  sb1  =  new  StringBuffer(num_levels+",  ■+num_buttons); 
out2.println(sb1  .toStrkigO); 
for(int  i=0;i<num  labels;i-r^-r’) 

{ 
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StrinoBunw  sb  *  mw  StringBuftartpagtCil  natM^*,  *'»pag*(n.gatPoaiionO''- 
*1  **p«g«{ncal«goria_tinM«*,  *‘»^pag^.num_raplic«); 
oulZpririiln(sb.toStrin0O);  ~ 

} 

StiIngBunir  abS  ■  imw  SbingBuffMfOrfginal  SMreh  Urn*  *  “*0*’^’* 
"Eatfenatod  naw  aaareh  tbna  ■  *'K)); 
ouaprMln(ab3.toStringO); 

} 

calch(Excaption  a) 

{ 

Syatam.ouLpfinlln(*Efror  *'»a.toStringO): 

} 


} 

// Thia  mathod  takaa  a  vactor  daacribing  a  pitfi  or  button  puahaa  and  ratuma  tha  Max 

//  of  ttM  lain  wth  that  path. 

public  bit  findPagawthPath(intfl  path) 

{ 

bit  itamx-1 ; 

for(int  H);l<num  labala;i‘*-»)  //  go  through  al  tema  bi  the  hiararchy 

{ 

boolaan  found_lt>  true; 

bit  chacm  *  naw  bit  [num_lavala]; 

chock  ■  paga(i].path; 

forOnt  )^;j<num  lavola;|‘^)  //  go  through  path  of  aach  bam  to  aaa  if  K  matchaa 

{ 

if(chack(n  I*  pathflD 

{ 

found  it«faiaa; 

} 

) 

ir(fbund  K) 

{ 

Ram  >  i; 

i>num  labala; 

} 

) 

return  Ram; 


//ThiamattiodawapathahiararchicalpoaRionaorhaoRama.  Ria 
//compbeatad  bacauaa  R  alao  haa  to  aarap  al  the  childron  of  thoaa  Rama, 
pubic  void  awapOnt  laval,int  Rem,  bit  naw  Rem) 

{ 

bit  tempo  *  bit(num_laval8]; 
bR  newJampQ  >  naw  bR{num_lavala]; 
bit  chaciiQD  *  naw  bit  (num.labatalQ; 

fbr(int  W);l<num_labela:i++) 
chack{l]  >  naw  bit(num_lavel8]; 

temp  -  paga[Rem].path; 
newje^  «  paga{naw_Ram].path; 

//  fbat  copy  aU  pattia  into  a  large  array  wRh  changaa  made 
fbr(int  i>0;i<num  labala;FM-) 

{ 

boolaan  changal  ■tnie,  changa2>trua; 

bit  hoUQ  >  naw  bit(num_lavala]; 

hold  >  paga{l].path; 

fbr(lntj»0;j<num  levala-J-M') 
chackOin  -  holdQ]; 


50 


forCmt  j=0:j<=level:j++) 

{ 

//  check  to  see  if  path  of  current  item  includes  the  to-be-swapped  paths 
if(checkp]0]  l^tempDD 
change1=false; 
if(check[i]D]  1=  newJempQD 
change2=false; 

} 

//  making  changes  in  path  of  current  item  (if  necessary) 
if(change1) 

check(i][level]  =  new_temp{level]; 
if(change2) 

checkli][level]  =  temp{level]; 


//  now  copy  everything  back  with  changes  irxduded 
fbr(int  i=0:i<num_labels;i+'*') 
page{i].setPath(check(i]); 

} 

//  end  of  Setup  class 
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import  Java.util.RarKk>m; 

Import  java.uUI.Date; 
import  java.k).*; 
import  Setup; 

r  ciaaa  Optimze 

Thia  daea  raada  in  data  from  'data/motor.txr  and  'datafaearch.tme.txr  and 
converts  that  data  into  separate  motor  artd  categorization  Umar  It  then  modifiea 
ttw  hierarchy  from  'datafeearch.Ume.txr  Into  orte  that  minimzea  predicted  search 
time.  The  final  hierarchy  is  stor^  in  the  fie 'data/oplimai.txr. 

Written  by  Greg  Francis,  Purdue  UniversKy 
August  1997 


The  views  opinions,  and/or  findings  contained  in  this  report  are  those  of  the  author 
and  should  not  be  consfrued  as  an  official  Department  of  the  Army  position,  or  decision, 
unless  so  designated  by  other  documentation. 


public  class  Optimize  exterals  Setup 

{ 

M  motor.timeQQ; 

M  aat>ororfginal_eat,  current.est,  local_minima; 

public  OpUmIzeO 

{ 

} 

pubic  static  void  main(String  argsQ) 

{ 

Optimize  f  *  new  OptimizeO; 

} 

r  This  method  reads  in  data  from  Nes.  It  reads  in  between-Xem  search  times  and 
hierarchical  layout  from  the  Ne  'data/search_ttme.txr  and  I  reads  motor  times 
from  the  fie  'data/motor.txT. 
overrides  method  in  super  */ 
pubic  void  get  data  from  NeQ 
{ 

//  Get  info  from  category  data  Nes 
try 
{ 

String  filename  >  *data/searchjtlme.txr; 

Fie  f  >  new  File(flename); 

FleInputStream  labels  >  rrew  FlelnputStream<f); 

DatalnputStream  labei.fle  >  new  DatalnputStream<tabeis}; 

H  Get  num_levels  and  num_bultons 
String  s  *  label_file.readLJri^; 

//parse  out  info 

//getnum_levels 

toll  end  >  s.indexOf(*,*); 

String  temp  *  s.subst)t1^0,end); 

num_levels  >  (lit)  Float. valueOf(temp).fioatValueO; 

//getnum_buttons 

temp  «  s.wbetring(end^1); 

num_buttons  >  (ini)  Float.valueOf(temp).floatValueO; 
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//  Compute  number  of  labels  in  Hierarchy  for  later  use 
fbr(int  i=0:i<num_levels:i++) 

numjabels  +=  (int)Math.pow((double)num_buttons,(clouble)i): 

//  Create  pages 

page  =  new  HierarchyPage(num_labels]; 

//  Create  array  for  motor_tinte 

motor_time  =  new  intInum_buttons+11Inum_buttons+1]; 

//  get  page  info  from  data  file 
fbr(int  i=0:i<num  labels;i++) 

{ 

s  =  label_file.readLineO; 

//parse  needed  information 
//get  name 

int  name_end  =  s.indexOff,"); 

String  name  =  s.substring<0,name_end); 

//  get  position 

int  position_end  =  s.indexOff  *,name_end+1); 

String  s2  =  s.substring(name_erKl+1  ,position_er>d): 
int  position  =  (int)  Float. valueOf(s2).fioat\/alueO; 

//  get  between-item  time 

int  time_end  =  s.indexOff  ,",position_end+2): 

String  s3  =  s.substring(position_end+2,time_end); 
int  time  =  (int)  Fioat.valueOf(s3).floatValueO; 

//get  repiications 

RTt  reps_end  =  s.iastindexOff  ,'0; 

s2  =  s.substring(reps_end+1 ); 

int  reps  =  (int)  Float. valueOf(s2).(loat\/alueO; 

//  set  up  page  info 

page{i]  =  new  HierarchyPage(  numjevels,  num_buttons,  name,  time, 
0,  reps); 

page{i].setPathfromPosition(position); 

} 

System.out.printlnf  Loaded  page  information.*); 

//  Get  actual  search  time  from  file 

s  =  label.file.readLineO; 

end  =  s.lastIndexOff  *); 

temp  =  s.substring(end+1); 

ast  =  (int)  Float.  vaiueOf(temp).floatValue0; 

} 

catch(Exception  e) 

{ 

System.outprintlnf  Error  ■+e.toStringO); 

} 

System.out.printlnf  Loaded  betwen-item  times.."); 

System.out.printlnf  Estimated  st  =  *+  compute_expected_search_timeO); 

System.out.printlnf  Loading  motor  data.”); 

//  Get  motor  parameters  from  data  file 
motor_time  =  new  int  (num_buttons+1Knum_buttons*1]; 
try 
{ 

String  filename  =  "data/motor.txT; 

FHe  f  =  new  File(filename); 

FHeInputStream  motor jjf  =  new  FilelnputStream(f); 

DataInputStream  motor_pd  =  new  DatalnputStream(motor_pf); 

fbr(int  l=0;l<num_buttons+1;i++) 
fbr(int  pO'J<num  buttons+1j++) 

{ 

float  time; 
double  stdev; 

String  s  =  motor_pd.readLineO: 

//  Parse  information  out  of  string 

//  First  5  spaces  are  button  codes  and  white  space 
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//  nMd  to  fkid  next  white  space  to  identify  and  of  time  integer 
intend«s.indexOfr*,5); 

String  s2  <■  s.sut)ati1ng(4,end); 
time  -  FloaLvaiueOf(t2).floatValijeO; 
motor  timaPli]  *  (int)  time; 

} 

System.out.println(*Loaded  ntotor  information.*); 

} 

catch(Exceplion  e) 

{ 

System.outprMln(*Error  *'»e.toStringO); 

} 

} 

/*  This  method  writes  a  hierarchy  to  the  Me  *data/optimat.txr. 
overrides  method  in  super  */ 
public  void  write  to  fll^ 

{ 

// Open  output  file 

try 

{ 

PrintStream  out2; 

FleOutputSIraam  out  Ae; 

out.fie  -  new  FleOu^utStreamrdata/optimal.txr); 

out2  >  new  PrinfStream(out_flle); 

StringBuffar  sbl  >  now  SlringBuffar(num_levolS'<’*.  '‘•■num_bultons); 
out2.priniln(ab1  .toStringO); 
for(lnt  M);i<num  labsls;l»>) 

{ 

StringBuftar  ab  *>  now  StringBuffar(page[i].name>*,  *'»page{i].gatPoeilionO'» 

*,  *>pagep].categorizo_time-»',  '‘•'pag^.num_repiics); 
out2.prin(ln(ab.toStringO); 

} 

StringBuftar  sb3  ■  new  StringBuftarfOriginal  search  time  »  •♦original_ost*'Vi*+ 
'Estimated  new  search  time  *  *'Kxirrent_eat); 
out2.priniln(sb3.toStringO); 

) 

catch(Exceplion  e) 

{ 

System.ouLprirainf  Error  *>e.toStringO); 

} 

} 

/*  This  method  creates  a  new  hierarchy  that  minimizes  predicted  search  time, 
overrides  method  in  super  */ 
public  void  create  new  hierarchyO 
{ 

Random  randGen  «  new  RandomO; 

//  Convert  seaich.thne  data  into  categotization_time  data  by  compensating  for 
//motor  times 

System.ouLprinUnCConverting  betweervttem  time  (Ma  Mo  categorization_time  data.*); 

for(inti«1;i<num  labeis;i'«~») 

{ 

M  D  path  «  new  int[num_levei4; 

M  level «  page(i].gelLevelO; 

Mctime^; 

lf(leval>0) 

ctime  >  page{i].categorizc_time  -  motor_time{path{level-i]]pathpevel]]; 

Oise  //movement  from  *Next  item*  buKon 

ctime  >  page{i].categorize_time  -  mator_time{8lpath(tavel]]; 
page(i].categorize  time>  ctime; 

} 

original_ost  *  compute_expected_search_timeO; 
curront_est  *  origiral_est; 
local_minima  >  original_eat; 
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Syste(T).out.printlnf  Actual  search  time  =  ‘■•'asH'NnEsiimated  search  time=  "-foriginaLest); 

//  actual  search  time  (ast)  and  estimated  search  time  (original_est)  may  differ 
//  due  to  rounding  errors 

//  initialize  simulated  annealing  parameters 
int  terr»p_courrt=0; 

double  temperaturejnit  =  (double)ast; 
double  temperature; 

boolean  foundJocal_minima  =  false; 

//  randomize  Hierarchy 

System.out.printlnf  Looking  for  a  new  local  minima.\nRandomizing  hierarchy...”); 
fbr(in*  ilem=1  ;item<numJabeis;item-'"«-) 

{  //  for  each  item,  swap  its  position  with  another  from  ttre  same  branch 

int  level  =  page{item].getLevelO; 

//now  pick  a  new  button  from  the  same  branch  in  the  hierarchy 
int  new_btn  =  page[item].path{level]; 
wNle(new_btn  ==  page[item].pathpevel]) 

new_btn  =  (int)(Math.ab^randGen.nextlntO)%num_buttons); 

//  identify  path  for  new  item 

int  new_tempQ  =  new  kit  [num_levels]; 

fbr(int  i=0;i<num_levels;i++) 

newjtempp]  =  pageptem].path[i]; 
new_temp{level]  =  new_btn; 

//  now  find  the  item  with  this  path 

kit  new.kem  =  findPagewithPath(new_temp); 

swap(level, item, new  item); 

} 

//  paths  scrambled,  compute  expected  search  time  for  scrambled  hierarch 
current_est  =  compute_expect^_search_time<); 

//  now  keep  going  through  search  process  until  it  finds  a  local  minimum 
while(!found  local  minima) 

{ 

System.out.printInCLooking  for  local  minima...*); 

//  Now  make  changes  to  the  Hierarchy 
int  count  =0; 

while(count  <num  labels) 

{ 

//  update  simulated  annealing  parameters 
temp_count+*; 

temperature  =  temperatureJnit/(2+0.0005*((double)temp_counf)); 

//  pick  an  item  at  random,  but  not  ttem  zero  (it  has  no  label) 
kit  item  =  (int)(Math.abs(randGen.nextlntO)%(numJabels-1))+1; 

//  get  button-presses  for  selected  page 
int  level  =  page[item].getLevelO; 

//now  pick  a  new  button  from  the  same  tree  in  the  hierarchy 
int  new_btn  =  pagefitem].path[level]; 
while(new_btn  ==  pageptem].pathpevel]) 

new_btn  =  (int)(Math.abs(randGen.nextlntO)%num_buttons); 

//  identify  path  for  new  item 

kit  new_tempQ  =  new  int  [num_levels]; 

for(int  i=0;i<num_levels;i++) 

new_temp{i]  =  pagepteml.pathp]; 
new_temp[level]  =  new_btn; 

//  now  find  the  item  with  this  path 

kit  new_item=findPagewithPath(new_temp); 

//  Now  swap  items 
swap(level,item,new_item); 
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//  If  search  time  doee  not  improve,  swap  tMck  w«h  probablty 
M  swap_ast  *  computs_s)(psctad_search_timeO; 

//computs  aimuMsd  anneaiing  protrablRy 

double  sajarob  «  Math.exp(-(double)swap_ost/temperature); 

sa_prob  ■  sa_prob/(1  ♦sa_prob); 

// pick  a  random  number  between  0  and  1 
double  prob  *  randGen.nextOoubleO: 

//  keep  swap  If  search  time  decreaaea.  or  random  number  leas  than  aa _prob 
lf(  swap  sat  <  cunent  sat  ||  aa_prob  >«  prob) 

{ 

System.outprMir)(ourrant_asi'»’  ’'»awap_aal'<'*  count«*«count 

tamp  ■"•HamparatunH"  ••*tamp_«»unt+*  *-*00 jxob+ ’’♦prob); 
count^O;  //reset  counter  of  norv4capth swaps 
cunent  aat>swap  ast;// update  currant  search  time 

) 

else  //  swap  back 

{ 

count'o;  //  update  counter  of  rtorv-kepi  swaps 
//swap  back  if  search  time  is  worse;  if  the  same,  doni  bother 
if(awap_est  >  current_eat) 
awap(levei, Kern, new  Item); 

) 

//  vwite  rtew  Hierarchy  to  fMe  If  I  is  the  boat  fourrd  so  far 
lf(curronl  eat  <  local  rnMnwAAtamp  count>rtum  labela) 

{  "  ■ 

local.minima  «  currara_aat; 

Systam.ouLprMin(V/rting  currant  beet  Hierarchy  to  Me  ‘bostb<t‘.\n*‘«' 

’  Eatimatad  search  tirrM  >  *'»currant_ast); 
write  to  fleO; 

) 

} 

//  attar  enough  inerteclive  swaps  (count  >  num.labeis) 

//  verify  that  we  have  a  local  minima,  otherwise,  keep  making  swaps 
fbund_local  minima  *  local  minima  check(cun'ent  est); 

} 

} 

/*  This  method  vsrifies  that  the  currant  hierarchicai  layout  is  a  local  minima, 
moaning  that  swapping  a  single  Rem  to  any  other  prasRiie  poeRion  in  Rs  branch 
would  not  decrease  the  predicted  search  time.  */ 
pubic  boolean  local  minima  check(int  current  est) 

{ 

Syatam.outprinllnCVerifying  that  we  have  a  local  minimtHn...’); 

// go  through  an  Rems 

fbr(int  Rom«0;Rsm<num_labeis;Rem-*^'r') 

rapics  >0)  //  make  certain  the  Rem  is  looked  at 

{ 

//  get  button-preasea  and  level  for  selected  page 

kit  tempo  *  [num_leveis]; 

temp  *  page(Rem].path; 

kit  ievsl  >  page{Rem].g^LsvalO; 

//now  go  through  aH  buttons  from  the  same  branch  ki  the  hierarchy 
for(inlnew  bln>0;new  btn<num  buttona;new  btn»'») 

{  "  ■  ■ 

//  build  path  for  swap-to  button 
kit  naw_tampO  ■  new  kit  (num_lovels]; 
for(int  i^,Knum_levala;i««^) 
new_tamp(i]  *  tsmp[i]; 
naw_temp(lev^  ■  new_btn; 

//  now  find  the  Rem  with  this  path 

kit  new_Rem>findPagewRhPath(new_temp); 

swap(level,Rem,new_Rem); 
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//  if  search  time  does  not  improve,  swap  back 
M  swap_est  =  compute_expected_search_timeO; 
if( swap  est < cument  //keep svmp 

{ 

cun’ent_est  =  swap_est; 

System.outprintlnfThis  was  not  a  local  minimum.*); 

return  false;//  exit  and  tell  the  optimization  procedure  to  keep  looking 

} 

else  //  swap  back 

{ 

swapflevel, item, new  item); 

} 

} 

) 

//  if  no  swap  improved  predicted  search  time,  the  currertf  layout  must  be  a 
//  local  minimum 

System.out.println(’This  was  a  local  minimum.*); 
return  true; 

} 

/*  This  method  takes  the  current  hierarchical  layout,  runs  through  all  the 
ttems  in  the  mission  scenario,  and  computes  the  predicted  search  time 
for  finding  all  the  items. 

It  does  this  by  noting  the  path  and  items  the  user  must  follow  and  categorize 
to  find  the  target  items.  It  then  adds  up  motor  and  categorization  times 
as  appropriate.  V 

public  int  compute  e)(pected_search  tirneQ 

{ 

intest=0; 


II  cycle  through  all  items  in  mission  scenario 
forint  i=0;i<num  labels;i'i-r-) 

{ 

if(page[i].num  replies  >0) 

{ 

kit  search Jtime  s  0; 
int  tempQ  =  new  int[numjevels]; 
temp  =  page[il.path; 

//  go  through  path  of  button  presses 
//always  starts  with  *NextTarger  (button  8) 
search_time  +=  motor_time[8]{temp[0]]; 
fbr(int  i^:k<num_levels-1;k++) 
if(temrtk]l— 1) 

{ 

if(templk+1)!— 1) 

search_time  +=  motorJime[temp{k]][temp(k-»^1]]; 

//  build  vector  for  currerrt  movement  through  path 
kit  new_tempn  =  new  kit  [numjevelsj; 
for(int  k2  =0;k2'<:num_levels;k2+*) 

{ 

if(k2<=k) 

new_temp[k2]  =  temp{k2]; 

else 

new  temp(k2]  =  -1; 

} 

//  now  find  the  item  with  this  current  path  and  add  its  categorization 
//  time  to  search  time  for  target  item 
kit  new_#em=findPagewithPath(newJtemp); 
search  time  +=  page{new  item].categorize_time; 

} 

//  multiply  search  time  for  item  by  number  of  times  it  is  searched  for 
est  +=  search  time*page[i].num_replics; 

} 

} 

return  est; 

} 

} 


57 


import  java.awt.*; 
import  Java.io.*; 

/*  cian  BuiMOpUmaiHiofarchy 


Thia  daaa  providat  an  intorfaca  to  go  through  tha  atapa  naadad  to  build  an 
optimal  hiaratchy.  It  caBa,  in  corractaaquancaotharprograma  that  gathar  naadad 
data  and  computa  tha  optimization  algorithm. 

Writtan  by  Greg  Francia,  Purdue  Univarafty 
Augu8t1997 


The  views  opinions,  and/or  findings  contained  in  this  report  are  those  of  tha  author 
and  should  not  be  construed  aa  an  official  Dapartmant  of  tha  Army  position,  or  decision, 
unless  so  designated  by  other  documentation. 

*/ 

public  class  BuildOptimalHierarchy  extends  Frame 

{ 

Button  bQ; 

public  BuildOptimalHierarchy(String  Utle) 

{ 

//  set  up  frame  with  option  buttorw 

auperftitle); 

//sat  size  of  display 
this.rasize(600,400); 

//Set  font 

Font  font  >  rtew  Fontf  Helvetica',Font.PLAIN,24); 
sotFont(font); 

//Create  menubar 

MenuBar  menubar  >  new  MenuBarQ; 

Menu  Me; 

this.setMaiuiBar(manubar); 

//Create  file  menu.  Add  Quit 
fMe>new  MenufFite*); 
fiie.add(naw  MenultemfQuir)); 
menubar.add(fiie); 

//create  buttons 

b  *  new  Button  [5]; 

b{0]  *  naw  Buttonf  Practice*); 

b{1  ] «  new  ButtonfMotor  data*); 

b(2i  >  new  Button(*Hierarchy  search*); 

bPl  >  naw  Button(*Optimization*); 

b[4j  >  naw  Button^esting*); 

satLayout(naw  GridLayout(5,1 ,1 0,20)); 
lbr(int  i*0;i<S;i++) 

{ 

add(b(iD; 

b[i].disableO; 

} 

b(0].enabie0; 

this.packO; 

this.ahowO; 


} 


public  static  void  main(String  argsO) 

{ 

BuildOptiinalHierarchy  ctnb  =  new  BuildOptimalHierarchyf  Build  Optimal  Hierarchy*); 


public  boolean  action  ( Event  e,  Object  arg) 

{ 

if(e.target  instanceof  Menultem) 

{  //Watch  for  quit  command 
String  label  =  (String)  arg; 
if(label.equalsfQuir))System.exit(0); 


if(e.target  instanceof  Button) 

{ 

if  (e.target  =  b[0])  //  User  goes  through  practice  trials 

{ 

b(0].setLabelf  Just  a  second...*); 
fbr(ii4  i=0;i<5;i++) 
b{i].disableO; 

Setup  stp  =  new  SetupQ; 
b[0].setLabelCPractice*); 

Practice  st  =  new  Practice(*Practice*); 

//  enable  button  for  next  step 

b(1].enable0; 

return  true; 

) 

else  if  (e.target  -=  b[1  ])  //  User  gathers  motor  time  data 

{ 

//  check  to  see  if  motor  time  data  is  already  gathered 
//  if  not,  gather  it 

File  f  =  new  File  ("data*, "motor .txT); 
if(lf.existsO) 

MotorTime  motor  =  new  MotorTtme("Motor  data*); 

fc)r(int  i=0;i<5;i++) 
b[i].disable(); 
b[2].enable0; 
return  true; 

} 

else  if  (e.target  ==  b[2])  //  User  gathers  between-item  time  data 

{ 

b[2].setLabel(*Just  a  second...’); 
fbr(int  i=0;i<5;i++) 
b{i].disable(); 

Setup  stp  =  new  SetupQ; 
b[2].setLabel(*Hierarchy  search*); 

SearchTime  st  =  new  SearchTime(*Hierarchy  search*); 

b{3].enable0; 
return  true; 

} 

else  if  (e.target  ==  b[3])  //  Computer  builds  model  and  creates  optimal  hierarchy 

{ 

fbrCmt  i=0;i<5;i++) 
b[i].disableO; 

b{3].setLabel(*Come  back  in  1/2  hour*); 

Optimize  opt  =  new  OptimizeQ; 
bp].setLabel(*Optimize*); 
b{4j.enable0; 
return  true; 
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•IM  If  (•.target  »b(^  // U««r  gathara  data  writh  ofitinial  hierarchy 

{ 

TeetHierarchy  th  >  new  TeetHierarchyfT  eedng*); 

for(int  W);K5:i>*) 
b(q.dieableO: 
return  true; 

} 

} 

return  falee; 

} 

} 
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